# Managing Storage Buckets

> 1. From the **Storage Buckets** page, click the **Add** button. The **Add Bucket** window is displayed.
2. Select the desired storage provider for this bucket.
3. Complete the required fields for your selected provider. Expand the next sections for field descriptions for each provider.

## Creating Storage Buckets

1. From the **Storage Buckets** page, click the **Add** button. The **Add Bucket** window is displayed.
2. Select the desired storage provider for this bucket.
3. Complete the required fields for your selected provider. Expand the next sections for field descriptions for each provider.

   **Field descriptions for Orchestrator storage buckets**:

   
   <colgroup>
   <col/>
   <col/>
   </colgroup>
   
   
   
   Field
   
   
   Description
   
   
   
   
   
   
   Name
   
   
   Enter a descriptive name for the new bucket.
   
   
   
   
   Description
   
   
   Enter an optional description for the new bucket.
   
   
   
   
   Bucket Options
   
   
   Configure the bucket options with the following two toggles:
   
   Readonly - when enabled, users have read-only access to the created bucket.
                                             
   Audit read access - when enabled, an audit record of all user access is maintained.
                                             
   
   
   
   
   
   Cancel
   
   
   Close the Add Bucket window without saving.
                                          
   
   
   
   
   Add
   
   
   Create the new bucket as defined.
   
   
   
   

   :::note
   Orchestrator storage buckets do not support SSE-KMS encryption.
   :::

   **Field descriptions for Azure storage buckets**:

   | 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](about-credential-stores.md) is used to store the provided password. |

   **Field descriptions for Amazon S3 storage buckets**:

   | 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`. |
   | **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](about-credential-stores.md) is used to store the provided password. |

   **S3 compatible storage buckets**:

   ![docs image](https://dev-assets.cms.uipath.com/assets/images/orchestrator/orchestrator-227467-a149ce65.webp)

   | Field | Descriptions |
   | --- | --- |
   | **Name** | Enter a descriptive name for the new bucket. |
   | **Description** | Enter an optional description for the new bucket. |
   | **Bucket name** | Enter the name of the S3 compatible bucket to be used. |
   | **Service URL** | Enter the service HTTP URL without the bucket name in the subdomain. For example, `https://storage.mycompany.example.com`. |
   | **Access key** | Enter the access key for your storage system. |
   | **Force path style** | Enable to force the use of Path-Style requests. Disable to use Virtual Hosted-Style requests. See details about [virtual hosting of buckets](https://docs.aws.amazon.com/AmazonS3/latest/userguide/VirtualHosting.html). |
   | **Advanced signature options** | Enable this option to provide advanced signature authentication options. When enabled, the **Signature version** and the **Signature method** fields are displayed. |
   | ? ? **Signature version** | Select the signing protocol. The following options are available: **V2** and **V4**. The default is **V4**. Most storage systems use this. |
   | ? ? **Signature method** | Select the type of hash algorithm used to encrypt the signature. The following options are available: **HmacSHA1** and **HmacSHA256**. The default is **HmacSHA256**. Most storage systems use this. |
   | **Secret key** | Enter the secret key for your storage system. |
   | **Orchestrator credential store for safekeeping the provided password** | Select which Orchestrator [credential store](about-credential-stores.md) is used to store the provided password. |

   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.
4. Click **Add**. Your bucket is created and available for use.

## 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.

:::note
The editable fields vary depending upon the storage provider used.
:::

1. Click **Update**. The bucket is updated and you are returned to the **Storage Buckets** page.

## 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 a File to 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 **Upload** button. The **Upload new file** window is displayed.

   ![docs image](https://dev-assets.cms.uipath.com/assets/images/orchestrator/orchestrator-229777-a81c04cb.webp)
3. Click the **Browse** button. Your file explorer is displayed, navigate to and select the desired file. Once selected, the **File full path** is automatically filled-in. The **File full path** can be edited, and the file uploaded to a virtual directory.
4. Click **Upload**. The file is uploaded and available in the storage bucket.

## 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.

## 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) 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:

![docs image](https://dev-assets.cms.uipath.com/assets/images/orchestrator/orchestrator-227411-98095f0c.webp)

* 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`.
