Create new buckets

You can create a bucket from the Cloudflare dashboard or using Wrangler.

Note

Wrangler is a command-line tool for building with Cloudflare's developer products, including R2.

The R2 support in Wrangler allows you to manage buckets and perform basic operations against objects in your buckets. For more advanced use-cases, including bulk uploads or mirroring files from legacy object storage providers, we recommend rclone or an S3-compatible tool of your choice.

Bucket-Level Operations

Create a bucket with the r2 bucket create command:

wrangler r2 bucket create your-bucket-name

Note

• Bucket names can only contain lowercase letters (a-z), numbers (0-9), and hyphens (-).
• Bucket names cannot begin or end with a hyphen.

The placeholder text is only for the example.

List buckets in the current account with the r2 bucket list command:

wrangler r2 bucket list

Delete a bucket with the r2 bucket delete command. Note that the bucket must be empty and all objects must be deleted.

wrangler r2 bucket delete BUCKET_TO_DELETE

Notes

• Bucket names and buckets are not public by default. To allow public access to a bucket, visit the public bucket documentation.
• Invalid (unauthorized) access attempts to private buckets do not incur R2 operations charges against that bucket. Refer to the R2 pricing FAQ to understand what operations are billed vs. not billed.