# Create a Bucket or Folder

Create a bucket (bare name) or a folder inside a bucket (bucket/folder/ with trailing slash).

**Alias:** `create`

## Usage

```bash
tigris mk <path> [flags]

t3 create <path> [flags]
```

Paths support the optional `t3://` (or `tigris://`) prefix (e.g. `t3://my-bucket/path` or just `my-bucket/path`). A trailing slash creates a folder inside the bucket.

## Flags

Flags only apply when creating a bucket (not folders).

| Name | Required | Default | Description |
| --- | --- | --- | --- |
| `--access`, `-a` | No | `private` | Access level. Options: `public`, `private` |
| `--public` | No | — | Shorthand for `--access public` |
| `--enable-snapshots`, `-s` | No | `false` | Enable snapshots for the bucket |
| `--allow-object-acl` | No | `false` | Allow per-object ACLs on the bucket |
| `--enable-directory-listing` | No | `false` | Enable directory listing, relevant for public buckets |
| `--default-tier`, `-t` | No | `STANDARD` | Default storage tier. Options: `STANDARD`, `STANDARD_IA`, `GLACIER`, `GLACIER_IR` |
| `--locations`, `-l` | No | `global` | 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`). |
| `--fork-of`, `--fork` | No | — | Create this bucket as a fork (copy-on-write clone) of the named source bucket |
| `--source-snapshot`, `--source-snap` | No | — | Fork from a specific snapshot of the source bucket. Accepts a snapshot version string or any UNIX nanosecond-precision timestamp. Requires `--fork-of` |
| `--consistency`, `-c` | No | — | **Deprecated.** Use `--locations` instead. |
| `--region`, `-r` | No | — | **Deprecated.** Use `--locations` instead. |

## Examples

```bash
# Create a bucket
tigris mk my-bucket

# Create a public bucket in a specific region
tigris mk my-bucket --access public --locations iad

# Create a bucket that allows per-object ACLs
tigris mk my-bucket --allow-object-acl

# Create a public bucket with directory listing enabled
tigris mk my-bucket --public --enable-directory-listing

# Create a folder in a bucket
tigris mk my-bucket/images/

# Using t3:// prefix
tigris mk t3://my-bucket

# Create a fork (copy-on-write clone) of an existing bucket
tigris mk my-fork --fork-of my-bucket

# Fork from a specific snapshot of the source bucket
tigris mk my-fork --fork-of my-bucket --source-snapshot 1765889000501544464
```

Forks are copy-on-write clones. Once created, use [`buckets rebase`](/content/docs/cli/buckets/rebase/index.html) and [`buckets merge`](/content/docs/cli/buckets/merge/index.html) to keep a fork in sync with, or promote it back to, its source.