From 867968ee6c672c0be39e9ac98d151afdbaecf737 Mon Sep 17 00:00:00 2001 From: "promptless[bot]" Date: Tue, 28 Jul 2026 21:02:48 +0000 Subject: [PATCH] Add resource tags documentation page (DOCS-479) Add accounts-billing/resource-tags.mdx describing organization-shared resource tags and add it to the Accounts and billing nav group. --- accounts-billing/resource-tags.mdx | 78 ++++++++++++++++++++++++++++++ docs.json | 1 + 2 files changed, 79 insertions(+) create mode 100644 accounts-billing/resource-tags.mdx diff --git a/accounts-billing/resource-tags.mdx b/accounts-billing/resource-tags.mdx new file mode 100644 index 00000000..9811538b --- /dev/null +++ b/accounts-billing/resource-tags.mdx @@ -0,0 +1,78 @@ +--- +title: "Resource tags" +description: "Organize, filter, and track usage of Runpod resources across your organization with tags." +tag: "NEW" +--- + +Resource tags are labels you create and apply to your Runpod resources to organize, filter, and track usage across your organization. By tagging resources, you can group them in ways that reflect how your teams, projects, and environments are structured. + +Tags are shared across your organization rather than defined per user. Once a tag exists, anyone working in your organization can apply it to supported resources, so the same set of labels stays consistent no matter who created a given resource. + +## Supported resources + +You can apply resource tags to the following resource types: + +| Resource type | Description | +|--------------|-------------| +| Pods | Tag individual Pods to organize compute resources. | +| Serverless endpoints | Tag endpoints to group related Serverless workloads. | +| Network volumes | Tag network volumes to track persistent storage. | +| Templates | Tag templates to organize reusable configurations. | +| Container registry auths | Tag container registry auths to organize registry credentials. | + +Resource tags support templates and container registry auths, which cost centers do not. Instant Clusters are not currently supported for tagging. + + +Resource tags and cost centers serve different purposes. Tags help you organize and filter resources, while [cost centers](/accounts-billing/cost-centers) track and attribute billing across your organization. You can use both together. + + +## Why use resource tags + +Tags give you a flexible way to categorize resources so you can find and understand them later. Common uses include: + +- Tracking usage for a specific team, project, or initiative. +- Separating environments, such as production versus staging. +- Organizing resources by team or project. +- Quickly filtering resources to find what you need. + +## Create a tag + +To create a tag, open the resource tags management area in the Runpod console, give it a name, optionally assign a color, and save it. The new tag then becomes available across your organization for anyone to apply. + + +Because tags are shared across your organization, a tag you create is immediately available for anyone in your organization to apply. Consider agreeing on your tags as a team so everyone uses the same set. + + +## Attach a tag to a resource + +You can apply a tag when you create a supported resource, or add one later from the resource's management view. Attaching an existing tag associates that resource with the tag without changing any other resources. + +## Filter resources by tag + +You can filter or search a resource list by tag to see every resource that shares that tag across your organization. This makes it easy to review all the resources associated with a given team, project, or environment in one place. + +## Update a tag + +You can update a tag to change its name, color, or metadata. Because tags are shared across your organization, updating a tag changes it for every resource that carries it. + +## Detach a tag from a resource + +You can remove a tag from a single resource without deleting the tag itself. Detaching a tag affects only that resource; the tag remains available and stays applied to any other resources that use it. + +## Delete a tag + + +Deleting a tag removes it entirely from your organization, including from every resource it is applied to. This affects all resources carrying the tag, not just one. + + +## Best practices + +A few habits help keep your tags useful and consistent as your organization grows. + +**Establish consistent naming conventions.** Agree on a naming scheme that reflects your teams, projects, and environments before you create tags. Predictable names make tags easier to apply correctly and to filter on later. + +**Tag resources at creation time.** Apply the appropriate tags when you create a resource rather than after the fact. This keeps your resources organized from the start and reduces cleanup work later. + +**Use tags to separate environments.** Apply distinct tags to production, staging, and other environments so you can quickly distinguish them and avoid acting on the wrong resources. + +**Periodically review and prune unused tags.** Revisit your tags from time to time and remove any that are no longer in use. Keeping the tag list current makes it easier for everyone in your organization to find and apply the right tags. diff --git a/docs.json b/docs.json index e0a2e738..cbbf1361 100644 --- a/docs.json +++ b/docs.json @@ -267,6 +267,7 @@ "accounts-billing/manage-accounts", "accounts-billing/billing", "accounts-billing/cost-centers", + "accounts-billing/resource-tags", "accounts-billing/referrals", "accounts-billing/manage-payment-cards" ]