Cloudflare R2 Object Storage
Use R2 for objects such as uploads, media, backups, and static assets. Fetch the linked documentation before implementing; API signatures, configuration, limits, and pricing belong in the current docs.
Choose an access path
- Use a Workers binding for object access inside a Worker: Workers API setup.
- Use the S3-compatible API for existing S3 clients or direct client access through presigned URLs: S3 setup. Check supported operations rather than assuming full S3 parity.
- Decide whether objects need application authorization, temporary access, or public delivery before exposing the bucket. See patterns.md.
Find the task
| Task | Reference |
|---|---|
| Bindings, credentials, local development, bucket settings | configuration.md |
| Object operations, metadata, conditions, multipart, CLI | api.md |
| Uploads, streaming, caching, public delivery, event processing | patterns.md |
| Pagination, conditional responses, failed uploads, limits | gotchas.md |
For other topics, discover pages through the R2 documentation index. Check pricing before estimating costs.