# Managing Storage Buckets
> 1. From the **Storage Buckets** page, select the **Add** button. The **Add Bucket** window is displayed.
2. Select the desired storage provider for this bucket.
3. Complete the general details for the selected provider.
4. Configure the **Bucket options**: **Readonly** - use the toggle to make this bucket read-only for users. **Audit read access** - use the toggle to enable auditing of user read access.
5. Select whether you want to add an additional layer of encryption to Orchestrator storage buckets or not using the **Store in encrypted format**.
## Creating storage buckets
1. From the **Storage Buckets** page, select the **Add** button. The **Add Bucket** window is displayed.
2. Select the desired storage provider for this bucket.
3. Complete the general details for the selected provider.
4. Configure the **Bucket options**: **Readonly** - use the toggle to make this bucket read-only for users. **Audit read access** - use the toggle to enable auditing of user read access.
5. Select whether you want to add an additional layer of encryption to Orchestrator storage buckets or not using the **Store in encrypted format**.
:::note
* This option is available only for storage buckets of type Orchestrator.
* The option is available only for organizations that have access to [customer-managed keys](https://docs.uipath.com/automation-cloud/automation-cloud/latest/admin-guide/customer-managed-keys)
* This option can only be enabled during bucket creation.
* This setting is irreversible after the bucket is created.
* Existing storage buckets cannot be updated to use this additional layer of encryption.
* To change the encryption setting later, you must create a new storage bucket.
:::
6. Select **Add**. Your bucket is now available for use.
### Orchestrator storage buckets
| Field | Description |
| --- | --- |
| **Name** | Enter a descriptive name for the new bucket. |
| **Description** | Enter an optional description for the new bucket. |
| **Labels** | Enter a [label](https://docs.uipath.com/orchestrator/automation-cloud/latest/user-guide/organizing-resources-with-tags#organizing-resources-with-tags) to help users identify the new bucket. |
| **Properties** | Enter [properties](https://docs.uipath.com/orchestrator/automation-cloud/latest/user-guide/organizing-resources-with-tags#organizing-resources-with-tags) to help users identify the new bucket. |
:::note
Orchestrator storage buckets do not support SSE-KMS encryption.
:::
:::important
When using Azure Storage accounts with firewall restrictions (**Selected networks**), the integration may not work if the storage account is in the same Azure region as your Orchestrator deployment.
This is due to an Azure limitation where IP network rules do not apply to services in the same region. As a result, whitelisting Orchestrator public IPs has no effect, and features such as queue archiving may fail.
To avoid this issue, use a storage account in a different region, or configure access using virtual network rules or private endpoints.
:::
### Azure storage buckets
:::note
CORS configuration is needed for Azure storage buckets. For more information, check the [CORS/CSP Configuration](https://docs.uipath.com/orchestrator/automation-cloud/latest/user-guide/cors-csp-configuration#cors%2Fcsp-configuration) page.
:::
| Field | Description |
| --- | --- |
| **Name** | Enter a descriptive name for the new bucket. |
| **Description** | Enter an optional description for the new bucket. |
| **Azure Storage container name** | Enter the name of the Azure Storage container to be used for this bucket. |
| **Azure Storage endpoint suffix** | Enter the [endpoint suffix](https://docs.microsoft.com/en-us/azure/storage/common/storage-powershell-independent-clouds#endpoint-suffix) of your Azure Storage environment. For example, the endpoint suffix for Azure Public is `core.windows.net`. |
| **Azure Storage account name** | Enter the Azure Storage account for this container. |
| **Azure Storage access password** | Enter the access key for the Azure Storage account being used. |
| **Credential Store** | Select which Orchestrator [credential store](https://docs.uipath.com/orchestrator/automation-cloud/latest/user-guide/about-credential-stores#credential-stores) is used to store the provided password. |
| **Labels** | Enter a [label](https://docs.uipath.com/orchestrator/automation-cloud/latest/user-guide/organizing-resources-with-tags#organizing-resources-with-tags) to help users identify the new bucket. |
| **Properties** | Enter [properties](https://docs.uipath.com/orchestrator/automation-cloud/latest/user-guide/organizing-resources-with-tags#organizing-resources-with-tags) to help users identify the new bucket. |
### Amazon S3 storage buckets
:::note
Feature availability depends on the cloud offering that you use. For details, refer to the [Feature availability page](https://docs.uipath.com/orchestrator/automation-cloud/latest/user-guide/orchestrator-feature-availability#orchestrator-feature-availability).
:::
:::note
CORS configuration is needed for Amazon storage buckets. For more information, check the [CORS/CSP Configuration](https://docs.uipath.com/orchestrator/automation-cloud/latest/user-guide/cors-csp-configuration#cors%2Fcsp-configuration) page.
:::
Field
Description
Name
Enter a descriptive name for the new bucket.
Description
Enter an optional description for the new bucket.
Amazon S3 bucket name
Enter the name of the Amazon S3 bucket to be used.
Amazon S3 region
Enter the region of your Amazon S3 account. For example us-east-1 .
Authentication type
Choose the desired authentication type:
Access Key: Use an Amazon S3 storage bucket using an access key.
Connection: Use an Amazon S3 storage bucket using an Integration Service connection. This option provides other authentication types through the Integration Service connection: Access key
Access key assume role
UiPath Managed Cross Account Assume Role
Table 1. Amazon S3 Connection
| Field | Description |
| --- | --- |
| **Connection** | Create a configure a new Integration Service connection for Amazon Web Services. Check the [Amazon Web Services authentication](https://docs.uipath.com/integration-service/automation-cloud/latest/user-guide/uipath-amazon-webservices-authentication) page from the Integration Service user guide for more information on how to create a connection. |
| **Labels** | Enter a [label](https://docs.uipath.com/orchestrator/automation-cloud/latest/user-guide/organizing-resources-with-tags#organizing-resources-with-tags) to help users identify the new bucket. |
| **Properties** | Enter [properties](https://docs.uipath.com/orchestrator/automation-cloud/latest/user-guide/organizing-resources-with-tags#organizing-resources-with-tags) to help users identify the new bucket. |
Table 2. Amazon S3 Access Key
| Field | Description |
| --- | --- |
| **Amazon S3 access key** | Enter the access key for your Amazon S3 account. |
| **Amazon S3 access password** | Enter the password for the Amazon S3 account being used. |
| **Orchestrator Credential Store** | Select which Orchestrator [credential store](https://docs.uipath.com/orchestrator/automation-cloud/latest/user-guide/about-credential-stores#credential-stores) is used to store the provided password. |
| **Labels** | Enter a [label](https://docs.uipath.com/orchestrator/automation-cloud/latest/user-guide/organizing-resources-with-tags#organizing-resources-with-tags) to help users identify the new bucket. |
| **Properties** | Enter [properties](https://docs.uipath.com/orchestrator/automation-cloud/latest/user-guide/organizing-resources-with-tags#organizing-resources-with-tags) to help users identify the new bucket. |
Figure 1. S3 compatible storage buckets
## Editing Storage Buckets
1. From the **Storage Buckets** page, click the **Edit** button corresponding to the desired bucket. The bucket is opened for editing.
2. Change the desired fields. The editable fields vary depending upon the storage provider used. See field descriptions by expanding the sections above.
3. Click **Update**. The bucket is updated and you are returned to the **Storage Buckets** page.
### Adding Tags to Storage Buckets
You can apply tags to a storage bucket either when creating one or editing an existing one. To add tags to a storage bucket when editing it, follow these steps:
1. From the **Storage Buckets** page, click the **Edit** button corresponding to the desired bucket. The bucket is opened for editing.
2. On the **Labels** field, start typing the name of the label. You can choose an existing label or create a new one.
3. On the Properties (key-value pairs) field, click Add new.
4. Add new keys and values. You can choose existing keys and/or values or you can create new ones.
5. When done, click **Update**. Your storage bucket is updated and the newly created tags, if any, become available for other objects.
### Removing Tags From Storage Buckets
To remove tags from a storage bucket, follow these steps:
1. From the **Storage Buckets** page, click the **Edit** button corresponding to the desired bucket. The bucket is opened for editing.
2. On the **Labels** field, click the **X** adjacent to the name of the label to remove it. The label is removed.
3. On the Properties (key-value pairs) field, click the **X** adjacent to the keys and/or values to remove them. The keys and/or values are removed.
4. To delete a key/value pair click the **Remove** icon corresponding to that entry. The key/value pair is removed.
5. When done, click **Update**. Your storage bucket is updated and tags are removed.
## Deleting Storage Buckets
1. From the **Storage Buckets** page, click the **Delete** button corresponding to the desired bucket.
2. You are prompted **Are you sure you want to delete the selected items?**
3. Select **No** to cancel or **Yes** to confirm and delete the selected bucket.
## Uploading Files to a Storage Bucket
1. On the **Storage Buckets** page, select the desired bucket to open it for viewing.
2. Select **Upload files**.
3. In the **Upload files** window, select **Browse**.
4. In your file explorer, navigate to and select the desired files, then confirm your selection.
5. In the **Files** field, rename the file if needed. You can rename files that have the same name to avoid name conflicts in the storage bucket.
:::note
If you select a single file, you can rename it. If you select multiple files, you can only check the total number of files.
:::
6. In the **Upload files** window, select **Upload** to make the files available in the storage bucket.
## Previewing a File From a Storage Bucket
:::note
You can only preview files if the browser supports in-browser viewing (for example, images or PDF files).
:::
1. From the **Storage Buckets** page, select the name of the desired bucket. The bucket is opened for viewing.
2. Select the file you want to preview. The file is opened in a new browser tab.
## Downloading a File From a Storage Bucket
1. From the **Storage Buckets** page, click the name of the desired bucket. The bucket is opened for viewing.
2. Click the **Download** button corresponding to the desired file. The download dialog is displayed prompting you to either open or save the selected file.
## Managing Storage Bucket Links
Sharing storage buckets between folders enables launching jobs in multiple folders without redesigning your workflows in Studio when the underlying processes are targeting the same bucket. Linking a bucket to a folder makes the bucket available in that folder.
:::note
A bucket linked to multiple folders is marked using the  icon. If the icon is not present, then the current folder is the only folder the bucket resides in. Deleting it here completely removes the bucket from Orchestrator. You need the **Storage Buckets - Create** permission in the folders where you want to add the bucket (target folders) and **Storage Buckets - View** in the folder where the bucket currently resides (original folder). If you have **Storage Buckets - Edit** in the target folder, you also require **Storage Buckets - Edit** in the original folder.
:::
### Linking Multiple Buckets to the Current Folder
1. In the **Storage Buckets** page, click **Add**. Three buttons are displayed allowing you to add a storage bucket, link one from other folders, or hide the options.
2. Select **Link from other folders**. The **Link Storage Buckets** window is displayed showing a list of all buckets in the folders in which you have View permissions on Storage Buckets.
3. On the **Select Storage Buckets** section, select one or multiple buckets from the list.
Figure 2. Linking storage buckets from other folders
4. Select **Continue**. You are directed to the **Folder Validation** section. Here you can see the folders the buckets are already linked to. If there are multiple folders, their names are displayed.
Figure 3. Validating folder
5. Select **Remove** for the corresponding bucket to revert the change or click **Exit** to cancel the operation.
6. Select **Link** if you want to make the link between the bucket you selected and the current folder. The buckets are displayed on the **Storage Buckets** page.
Figure 4. Storage Buckets page
### Linking a Bucket to Multiple Folders
1. Navigate to a folder the bucket to be linked resides in or is linked to.
2. Select **More Actions** > **Manage Links** for the desired bucket to open the **Manage Links** window. The **Manage Bucket Links** window is displayed.
Figure 5. Linking a bucket to multiple folders
3. Select **Update**. A confirmation window is displayed.
4. Select **Cancel** if you want to abort the changes or **Continue** for the changes to take effect. The operations are now reflected in Orchestrator according to your changes.
### Unlinking Buckets From Folders
Unlinking buckets from folders can be performed in a manner similar to the linking operation. Navigate to the link-management areas presented in the procedures above and remove the connections between a certain bucket and a certain folder.
Alternatively, you can remove a bucket using the **Delete** functionality. See [Deleting a Bucket](https://docs.uipath.com/orchestrator/automation-cloud/latest/user-guide/managing-storage-buckets#managing-storage-buckets).
:::important
Removing a bucket that exists in multiple folders only removes it from the folder where the removal operation takes place, it does not remove it from the other folders as well. In order to completely delete a bucket, you must remove all its existing links.
:::
## Searching for Files Within a Storage Bucket
The file search option within storage buckets is based on [file globbing](https://learn.microsoft.com/en-us/dotnet/core/extensions/file-globbing#pattern-formats), which means that you need to use wildcards to find a desired file. This is detailed in the topic dedicated to the [List Storage Files](https://docs.uipath.com/activities/docs/list-storage-files#storage) activity, but you can also check out the example below for some common use cases.
### Example
Suppose you have a storage bucket containing the following files:
Figure 6. Browsing storage buckets
* If you want to search for all files with a certain extension, such as .jpg files, you need to enter the following in the **Search** field: `*.jpg`.
The search results will be `doc1.jpg` and `doc2.jpg`.
* If you want to search for a file whose name contains a certain character or character sequence, such as `voi`, you need to enter the following in the **Search** field: `*voi*`.
The search result will be `invoice1.pdf`.
* If you want to search for a file whose name begins with a certain character or character sequence, such as `u`, you need to enter the following in the **Search** field: `u*`.
The search result will be `uipath.png`.