Centralized tag management

View, create, rename, merge, delete, and restore tags across BrowserStack products from one place.

Tags are labels you attach to builds, test runs, test cases, test plans, and other entities to group and filter them across BrowserStack products. Over time, tags get duplicated, misspelled, or abandoned. Tag Manager shows admins every tag in the organization, who created it, and where it’s used, so they can clean up the library without changing how teams apply tags.

Permissions to manage tags

Tag permissions are organization-level RBAC permissions and come from your BrowserStack organization role. The following table lists the tag permissions for each role:

Service accounts have their own roles:

The SVC_Ingestor role is meant for CI pipelines and other integrations that upload test results. It can create the tags that arrive with an upload, but it can’t browse or manage the tag library.

For all RBAC permissions, see Roles and permissions and Service account roles and permissions.

Tags applied through builds and test runs

Attaching or removing an existing tag needs no tag permission, only permission to update the entity. For example, tagging a test case requires permission to update test cases.

Creating a new tag from any source, including the product UIs, API, or automation runs such as builds and test runs, requires the Create tag permission.

Open Tag Manager

The Manage Tags dashboard appears.

The tag list shows the following for each tag:

• Tag name: Unique name of the tag
• Usage: Number of entities the tag is attached to.
• Last used: When the tag was last attached to an entity.
• Created by: The user who created the tag. Older tags, and tags created by builds and uploads using a project token, have no recorded creator.

By default, tags are sorted by name in ascending order. To change the order, click Sort by and select one of the following options:

• Tag name (A → Z)
• Tag name (Z → A)
• Created (Newest first)
• Created (Oldest first)

Search and filter tags

Enter part of a tag name in the Search field. The list updates as you type.

Click the Filter icon to filter by any of the following:

• Entity type: Tags attached to a type of entity. Select Test case, Test run, Test plan, Shared step, Build, Test execution, or Project. The default is Any entity type.
• Created by: Tags created by a specific user. Only recently created tags have a recorded creator, so older tags don’t appear in the results when you use this filter.

• Created: Tags created within a time period. Select Last 7 days, Last 30 days, or This quarter. The default is Any time.

  

Create a tag

You can create tags in Tag Manager. Tags can also be created from existing flows, such as automation runs or product UIs.

To create a tag in Tag Manager:

View tag details

Click a tag to open its details panel. The panel shows the tag name and the following details:

• Associations: Total number of entities the tag is attached to.
• Created by: The user who created the tag.
• Created on: The date and time the tag was created.
• Last used: The date and time the tag was last attached to an entity.

• Usage: Entity count by entity type, such as test cases.

  

To rename, merge, or delete the tag, click Actions and select an option.

Rename a tag

Renaming requires the Edit tag permission.

Merge tags

Merge combines multiple source tags into one target tag. You choose which tag survives as the target.

Every mapping from the other tags moves onto the tag you keep. The other tags are permanently deleted, and their names disappear from the tag list.

Delete and restore tags

Deleted tags move to the Trash, where they stay recoverable for 30 days. After that, BrowserStack permanently removes them and their links to entities. You can’t permanently delete a tag from the trash yourself.

To delete tags:

To restore tags:

Restored tags return to the tag list with their usage counts and are re-attached to every entity they were applied to before deletion.