Skip to content

Commit a6d8deb

Browse files
committed
docs: consolidate changelog into single entry, add future roadmap context
1 parent 9a3fafd commit a6d8deb

2 files changed

Lines changed: 23 additions & 32 deletions

File tree

Lines changed: 23 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,35 @@
11
---
22
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.
44
date: 2026-01-28
55
---
66

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.
812

913
### What's included
1014

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.
1528

16-
### Limitations
29+
### Current limitations
1730

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.
2234

2335
To get started, refer to the [Resource Tagging documentation](/resource-tagging/).

src/content/changelog/resource-tagging/2026-03-25-expanded-roles-and-aot-updates.mdx

Lines changed: 0 additions & 21 deletions
This file was deleted.

0 commit comments

Comments
 (0)