team=payments or cost-center=1042. Use them to record ownership, cost attribution, or any other classification your project hierarchy does not express, then find environments by tag and act on them in bulk.
A tag key holds one or more values. An environment tagged team=payments and team=platform carries one key with two values, and each pair renders as its own chip.
Project tags are a separate, simpler feature: plain labels with no keys and no values.
Limits
Editing tags requires the Edit Environment Settings permission, the same permission that gates every other environment setting. Without it, the environment’s tags are shown as read-only chips.
Edit an environment’s tags
1
Open the environment's settings
From the Project Environments tab, click the environment, then open the Settings tab and scroll to the Tags card.
2
Add a tag
Click + New tag and type the key in the left field.
3
Add values
In the values field, type a value and press Enter. Repeat for as many values as the key needs. Values already used with that key elsewhere in your organization appear as options, and Add all applies every one of them at once.
4
Save
The counter under the editor shows how many of the 50 pairs you have used. Click Save to apply the changes.
Find environments by tag
Tags appear in two places, and each one searches differently.Project environments list
Each environment card shows up to four tag chips, with a+N chip for the rest. The search box at the top of the list matches tags along with names, templates, and statuses, so typing payments returns environments tagged team=payments.
Explorer
The Explorer table has a tags column with its own filter. Open the filter and tick one or morekey=value pairs, and the table narrows to environments carrying any of the ticked pairs. The filter has a search box, so you can type to find a pair in a long list.
Explorer covers every active environment in your organization across projects, and its filter selection persists in the page URL, so a tag-filtered view is a link you can share.
Explorer lists active environments. To find tags on inactive environments, use the API.
Add and remove tags in bulk
The bulk operations wizard has two tag commands. Filter Explorer by tag, or select environments from the project environments list, then click Perform Action and pick a command. Add Tags applies the same tags to every selected environment. Fill in keys and values with the same editor used in environment settings. A key that already exists on an environment has its values replaced, and keys you do not list are left untouched. Remove Tags takes a list of keys and removes each one from every selected environment, values and all. A key an environment does not carry is skipped. Both commands require the Edit Environment Settings permission on each selected environment. The wizard’s summary step marks environments you cannot edit with a failure icon and skips them. The rest of the selection is processed.Next steps
- Managing Bulk Operations - Run deploy, destroy, and other actions across many environments.
- Explorer - Search and manage all environments in one view.
- Environment Overview - All actions available on an individual environment.