Skip to main content

Bucket settings

Select a bucket and press ⌘I, or use File → Edit Bucket.

Screenshot placeholder: the bucket settings sheet showing Access, Bucket info, Lifecycle rules, CORS rules, Object Lock and Encryption.

Everything in this sheet is saved together, and B2 is told which revision you started from. If someone else changed the bucket while you had it open, the save is refused and says so, rather than quietly overwriting their work.

Access

Private means every read needs a key. Public means anyone with a file's URL can read it, with no key at all. Public is the one that can cost you, so it is the one the app colours.

Bucket info

Arbitrary key-values stored with the bucket. Saving replaces the whole set, so anything you remove here is removed on B2.

Lifecycle rules

See Lifecycle rules and the two clocks.

CORS rules

Only needed if a web app in a browser reads from this bucket directly. If nothing does, leave it empty: that is the safe answer.

A rule names the origins allowed, and which operations they may perform.

The operations span two APIs, and this is the part people get wrong. B2 can be reached through its own native API and through an S3-compatible one. A rule that permits every native operation still blocks a browser talking to the S3 endpoint, and the error the browser reports will not tell you that. Bucketree groups the two families separately and says in plain words what the rule will actually allow.

An origin is a scheme, a host and a port, with no path. https://example.com, not https://example.com/app. A page served from www.example.com is a different origin from one served from example.com.

Object Lock and Encryption

See Protecting files from deletion.