Tags (2)

Last updated Apr 21, 2026 Use tags to organize, search, and filter user Workers at scale. Tag Workers based on customer ID, plan type, project ID, or environment. After you tag user Workers, you can perform bulk operations like deleting all Workers for a specific customer.

Note

You can set a maximum of eight tags per script. Avoid special characters like , and & when naming your tag.

Add tags via dashboard

  1. Go to Workers for Platforms in the Cloudflare dashboard and select your namespace.
  2. Select a user Worker from the list.
  3. Go to Settings > Tags.
  4. Add your tags (for example, customer-123, pro-plan, production).
  5. Select Save.

You can also search and filter Workers by tags in the namespace view.

Tags API reference

For complete API documentation, refer to Workers for Platforms API.

Get script tags

Fetch all tags for a Worker script.

<details>

<summary>

Required API token permissions

</summary>

At least one of the following <a href="https://developers.cloudflare.com/fundamentals/api/reference/permissions/">token permissions</a> is required:

  • <code>Workers Tail Read</code>
  • <code>Workers Scripts Write</code>
  • <code>Workers Scripts Read</code>

</details>

List Workers for Platforms Script Tagsbash

curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/workers/dispatch/namespaces/$DISPATCH_NAMESPACE/scripts/$SCRIPT_NAME/tags" \
    --request GET \
    --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

Set script tags

Replace all tags on a Worker script. Existing tags not in the request are removed.

<details>

<summary>

Required API token permissions

</summary>

At least one of the following <a href="https://developers.cloudflare.com/fundamentals/api/reference/permissions/">token permissions</a> is required:

  • <code>Workers Scripts Write</code>

</details>

Replace Workers for Platforms Script Tagsbash

curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/workers/dispatch/namespaces/$DISPATCH_NAMESPACE/scripts/$SCRIPT_NAME/tags" \
    --request PUT \
    --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

Add a single tag

Add one tag to a Worker script without affecting existing tags.

<details>

<summary>

Required API token permissions

</summary>

At least one of the following <a href="https://developers.cloudflare.com/fundamentals/api/reference/permissions/">token permissions</a> is required:

  • <code>Workers Scripts Write</code>

</details>

Create Workers for Platforms Script Tagbash

curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/workers/dispatch/namespaces/$DISPATCH_NAMESPACE/scripts/$SCRIPT_NAME/tags/$TAG" \
    --request PUT \
    --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

Delete a single tag

Remove one tag from a Worker script.

<details>

<summary>

Required API token permissions

</summary>

At least one of the following <a href="https://developers.cloudflare.com/fundamentals/api/reference/permissions/">token permissions</a> is required:

  • <code>Workers Scripts Write</code>

</details>

Delete Workers for Platforms Script Tagbash

curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/workers/dispatch/namespaces/$DISPATCH_NAMESPACE/scripts/$SCRIPT_NAME/tags/$TAG" \
    --request DELETE \
    --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

Filter Workers by tag

List all Workers that match a tag filter. Use tag:yes to include or tag:no to exclude.

<details>

<summary>

Required API token permissions

</summary>

At least one of the following <a href="https://developers.cloudflare.com/fundamentals/api/reference/permissions/">token permissions</a> is required:

  • <code>Workers Tail Read</code>
  • <code>Workers Scripts Write</code>
  • <code>Workers Scripts Read</code>

</details>

List Workers for Platforms Scriptsbash

curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/workers/dispatch/namespaces/$DISPATCH_NAMESPACE/scripts?tags=production%3Ayes" \
    --request GET \
    --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

Delete Workers by tag

Delete all Workers matching a tag filter. Use this to bulk delete Workers when a customer leaves your platform.

<details>

<summary>

Required API token permissions

</summary>

At least one of the following <a href="https://developers.cloudflare.com/fundamentals/api/reference/permissions/">token permissions</a> is required:

  • <code>Workers Scripts Write</code>

</details>

Delete Workers for Platforms Scriptsbash

curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/workers/dispatch/namespaces/$DISPATCH_NAMESPACE/scripts?tags=customer-123%3Ayes" \
    --request DELETE \
    --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

Was this helpful?

YesNo

On this page

Tags (2) - 图1Docs

{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/cloudflare-for-platforms/workers-for-platforms/configuration/tags/#page","headline":"Tags","description":"Organize, search, and filter user Workers by custom tags like customer ID or plan type in Workers for Platforms.","url":"https://developers.cloudflare.com/cloudflare-for-platforms/workers-for-platforms/configuration/tags/","inLanguage":"en","image":"https://developers.cloudflare.com/cloudflare-for-platforms/workers-for-platforms/configuration/tags/og.png?v=68798b3824506bbb","dateModified":"2026-04-21","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}}

description: Deploy a Workers for Platforms starter kit and create your first multi-tenant platform on Cloudflare. title: Get started image: https://developers.cloudflare.com/cloudflare-for-platforms/workers-for-platforms/get-started/og.png?v=d15bc0342a467677

Skip to content

Documentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/cloudflare-for-platforms/llms.txt
Use this file to discover all available pages before exploring further.