|
1 | 1 | --- |
2 | 2 | title: Resource Tagging enters public beta |
3 | | -description: Cloudflare customers can now attach key-value metadata to resources via API. |
| 3 | +description: Attach key-value metadata to Cloudflare resources for organization, access control, and cost attribution -- available now via API on all plans. |
4 | 4 | date: 2026-01-28 |
5 | 5 | --- |
6 | 6 |
|
7 | | -Resource Tagging is now available in public beta. The feature enables attaching custom key-value metadata to Cloudflare resources for organization, access control, and billing attribution. |
| 7 | +Resource Tagging is now available in public beta across all Cloudflare plans. You can attach custom key-value metadata to your Cloudflare resources -- Workers scripts, zones, custom hostnames, Access application policies, and more -- giving you a consistent way to organize, query, and manage infrastructure at any scale. |
| 8 | + |
| 9 | +### Why tags matter |
| 10 | + |
| 11 | +As teams grow and resource counts climb, knowing what's running, who owns it, and why it exists becomes increasingly difficult. Resource Tagging gives you a single, API-first system to answer those questions. Tag a Worker with `team=payments` and `environment=production`, then filter across your entire account to find every production resource owned by the payments team -- regardless of resource type. |
8 | 12 |
|
9 | 13 | ### What's included |
10 | 14 |
|
11 | | -- **7 supported resource types** -- `account`, `workers_script`, `workers_script_version`, `zone`, `managed_client_certificates`, `custom_hostnames`, and `access_application_policy`. |
12 | | -- **Tag filtering** -- Query tagged resources with AND/OR logic, negation, and key-only matching via the `tag` query parameter. |
13 | | -- **Account and zone-level endpoints** -- Full CRUD operations for both scopes. |
14 | | -- **Account Owned Token (AOT) authentication** -- Tags use account-level tokens independent of individual users, ensuring automation workflows survive user lifecycle changes. |
| 15 | +- **7 supported resource types** -- `account`, `workers_script`, `workers_script_version`, `zone`, `managed_client_certificates`, `custom_hostnames`, and `access_application_policy`, with more on the way. |
| 16 | +- **Powerful filtering** -- Query tagged resources using AND/OR logic, negation, and key-only matching. Combine up to 20 filters per query with up to 10 OR values per filter to build precise resource views. |
| 17 | +- **Account and zone-level endpoints** -- Full CRUD operations across both scopes, so you can tag account-wide resources and zone-specific resources with the same consistent API. |
| 18 | +- **Account Owned Tokens (AOTs)** -- Tagging uses account-level tokens that persist independently of individual users. When someone leaves your team or rotates credentials, your tagging automation keeps running. AOTs are provisioned on your behalf with the correct permissions out of the box. |
| 19 | +- **Flexible role support** -- Super Administrators, Workers Admins, and Tag Admins can all manage tags, giving you flexibility in how you delegate tagging responsibilities across your organization. |
| 20 | + |
| 21 | +### API-first by design |
| 22 | + |
| 23 | +The API is the primary interface for Resource Tagging and the recommended path for all workflows -- whether you're scripting one-off tag assignments, building CI/CD pipelines, or integrating tagging into your infrastructure-as-code toolchain. A Dashboard UI is under active development and will complement the API when available. |
| 24 | + |
| 25 | +### What's coming next |
| 26 | + |
| 27 | +Resource Tagging is the foundation for several capabilities we're building toward. In future releases, expect support for **additional resource types** across the Cloudflare platform, **tag-based access control policies** that let you scope user permissions to tagged resources, **billing and usage attribution** by tag so you can break down costs by team, project, or environment, and **Terraform provider support** for managing tags declaratively alongside the rest of your Cloudflare configuration. |
15 | 28 |
|
16 | | -### Limitations |
| 29 | +### Current limitations |
17 | 30 |
|
18 | | -- API-only access (no Dashboard UI). |
19 | | -- `PUT` replaces all tags on a resource (no partial update). |
20 | | -- `DELETE` removes all tags (no single-tag delete). |
21 | | -- Querying tags for an untagged resource returns `500` instead of `404`. |
| 31 | +- `PUT` replaces all tags on a resource (no partial update). Use the [GET, merge, PUT workflow](/resource-tagging/how-to/manage-tags/#add-a-single-tag) to modify individual tags safely. |
| 32 | +- `DELETE` removes all tags from a resource. To remove a single tag, PUT the remaining tags back. |
| 33 | +- Querying tags for a resource that has never been tagged returns `500` instead of `404`. This is a known beta limitation. |
22 | 34 |
|
23 | 35 | To get started, refer to the [Resource Tagging documentation](/resource-tagging/). |
0 commit comments