# tigris buckets set

Update settings on an existing bucket such as access level, location, caching, or custom domain.

**Alias:** `s`

## Usage[​](#usage "Direct link to Usage")

```
tigris buckets set <name> [flags]

t3 b s <name> [flags]
```

## Flags[​](#flags "Direct link to Flags")

| Name                          | Required | Default | Description                                                                                                                                                                                                                                         |
| ----------------------------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--access`                    | No       | —       | Bucket access level. Options: `public`, `private`                                                                                                                                                                                                   |
| `--locations`                 | No       | —       | Bucket location. Options: `global`, `usa`, `eur`, `ams`, `fra`, `gru`, `iad`, `jnb`, `lhr`, `nrt`, `ord`, `sin`, `sjc`, `syd`. Supports comma-separated values for dual region (e.g. `ams,fra`). See [locations docs](/docs/buckets/locations/.md). |
| `--region`                    | No       | —       | **Deprecated.** Use `--locations` instead.                                                                                                                                                                                                          |
| `--allow-object-acl`          | No       | —       | Enable object-level ACL                                                                                                                                                                                                                             |
| `--disable-directory-listing` | No       | —       | Disable directory listing                                                                                                                                                                                                                           |
| `--cache-control`             | No       | —       | Default cache-control header value                                                                                                                                                                                                                  |
| `--custom-domain`             | No       | —       | Custom domain for the bucket                                                                                                                                                                                                                        |
| `--enable-delete-protection`  | No       | —       | Enable delete protection                                                                                                                                                                                                                            |

## Examples[​](#examples "Direct link to Examples")

```
# Make a bucket public

tigris buckets set my-bucket --access public



# Set location restrictions and cache control

tigris buckets set my-bucket --locations iad,fra --cache-control 'max-age=3600'



# Set a custom domain

tigris buckets set my-bucket --custom-domain assets.example.com
```