Tagging stories with labels

Labels are tags that can be associated with stories. You can use them to organize your Icebox and keep track of related stories (e.g., all the stories for a feature or a release). They can help make aspects of your workflow more visible and call out stories that are blocked or need discussion.

Like stories, releases, and user roles, labels are specific to a particular project. However, you may have the same label name in more than one project. If you have the same label name in two different projects, and you search by that label in the stories view of one of the projects, you will only see stories from the current project. However, if you’re in a Workspace that contains both projects and you search on the label, all stories containing that label in both projects will be returned.

Adding a label to a story

The label field in an expanded story, including drop-down suggestions

  1. In an expanded story, or when creating a new story, click into the Labels field and type the name of the desired label. If the label does not already exist, the label will be created upon pressing enter (or clicking outside of the Labels field).

  2. If a label already exists that matches what you type, you’ll see it appear in a list below the Labels field. Click it, or use the down key to select it, and hit Enter.

  3. The down-arrow icon at the end of the Labels field allows you to choose an existing label quickly with the mouse.

Labels panel

You can see all labels in a project from the Labels panel. Just click Labels in the navigation sidebar to open it.

Opening the label panel from the 'labels' option in the sidebar menu

If you click on a specific label in the Labels panel, in a story card, or in an expanded story, an automatic search query will show all stories with that label.

In collapsed stories, you can also click on labels displayed next to story titles to perform a search for that label.

Label search links visible in a collapsed story

Deleting, renaming, or converting a label

To delete or rename a label, open the Labels panel by clicking Labels in the sidebar. Mousing over a label in that panel reveals a cog icon that allows you to rename or delete that label. You will also see options to convert the label to an epic or show all stories associated with the label.

A cog icon menu for deleting, renaming or converting a label in the label panel

When you delete a label, it will remove the label name from the Labels panel, and remove that label from any stories that contain it. It will not delete the stories. When you rename a label, it will update the label name in all stories that have that label. When you convert a label to an epic label, it will create an epic with the same name as the label (and the same stories will be associated with the newly converted epic).

Removing a label from a story

To remove a label from a story, expand the story and click x to the right of the label that you’d like to remove.

Shows the X on each label in a story's label field, to use for removing those labels from the story

You can also select multiple stories and remove labels using the Add/Remove Labels option in the Bulk Actions menu that appears at the top left of the Project page.

Backlog-to-Current flow
Working with tasks