Use Tags

Tagging is a way to group or identify collections of work items . It provides all team members the ability to logically group and filter user stories, defects, defect suites, test cases, test sets, and tasks. Tagging is one way teams can identify work items as part of feature initiatives or projects that may span multiple timeboxes.

Using tags includes the following:

Manage Tags

Inside the editor windows of defects, defect suites, test cases, test sets, and user stories. The Tags field is located under the Name field.

Create New Tags

  • Tags are limited to 32 characters.
  • Only letters and numbers are accepted characters.
  • To write a query with tags, use the format "Tags.Name = X".
  • Like custom fields, tags are workspace -specific and unlike custom fields, tags are not work item-specific. A single tag exists within the workspace it was created in, but can be used across defects, defect suites, stories, test cases, and test sets.
  • Tag archiving and renaming can be done by your administrator, or through the WSAPI with workspace administrator permissions .
  • Tags are case-insensitive, except when an archived tag is added back in the course of tagging a work item. In this case, you may inadvertently create duplicate tags, for example, Regression and regression.
To create a new tag:
  1. Inside a work item editor window, select the Choose Tags drop-down.
  2. Select New Tag. A pop-up text field displays.
  3. Enter the new tag name, and select Save. The tag is now available for use, and displays with a checkbox next to it.

Find Existing Tags

If the tag you want to apply to your work item already exists:
  1. Inside a work item editor window, select the Choose Tags drop-down.
  2. Begin typing the name of your tag. A case-insensitive search will be performed while you type, and matching tags display below the text field.

Assign Tags

Once you have located your tags in the editor window:
  1. Select the checkbox next to the tag name, and select Apply. The tag name displays next to the Tags field.
  2. Select Save.

Remove Tags

To remove an existing tag from a work item:
  1. Inside a work item editor window, select the Choose Tags drop-down.
  2. Assigned tags display underneath the heading Selected Tags.
  3. Deselect the checkbox next to the tags you want to remove.
  4. Select Apply. The tag name no longer display next to the Tags field.
  5. Select Save.

If you want to remove a tag from the workspace so it is no longer a selection when editing work items, your administrator must archive or delete the tag. Your administrator can also rename or edit an existing tag.

Use Tags in Custom Views

Tags are available as filter parameters in custom views to allow you to filter for specific tags on summary pages. This is useful for creating views that only show work items tagged as part of your feature initiative or project.

Note: Filters on tags are currently available with the contains operator. If you are unsure of your complete tag name, entering a partial name will show any tags that match. CA Agile Central will also search for matches while entering text into the filter parameter field.

Tags custom view

Bulk Tagging

Bulk tagging allows you to quickly apply the same tag to multiple items.

Note: Bulk tagging is currently available from the Backlog page, Iteration Status page, and the Custom List app.
To add or remove tag for multiple backlog items:
  1. Select the checkbox for the items that you want to tag or untag. The gear gear menu menu switches to bulk edit mode.
  2. Select the bulk edit mode gear menu and select Tag.
  3. On the Bulk Tag editor, select an existing tag, or create a new tag by typing the tag name in the search field and selecting Create New.
  4. Select Apply to add the tag to the selected items.


Need more help? The CA Agile Central Community is your one-stop shop for self-service and support. To submit feedback or cases to CA Agile Central Support, find answers, and collaborate with others, please join us in the CA Agile Central Community.