This page last changed on Oct 24, 2010 by rosie@atlassian.com.

On this page:

About labels

Labelling allows you to categorise an issue(s) in a more informal way than assigning it to a version or component.

When viewing an issue, the issue's labels appear in the 'Details' section:

Screenshot: the 'Details' section within an issue

If your JIRA administrator has added any custom fields of type 'Label', they will be shown below the 'Labels' field. For example, if you are using GreenHopper, a field called 'Epic' will be shown (see the GreenHopper documentation on Working with Epics.
You can click a label (e.g. 'doc' in the above screenshot) to jump to the Issue Navigator and see a list of all issues which have that label.

You can also:

Adding a label to an issue

  1. View the issue which you want to label.
  2. Click the 'edit' icon which appears to the right of the word 'Labels':
  3. In the pop-up dialog box that appears, either type your label and press the <Enter> key, or click the down-arrow icon to select from a list of suggestions.

    You can type multiple labels, separated by spaces.
  4. Normally when you edit and save an issue, certain people are notified via email.
    • If you want the normal notification email to be sent, select the 'Send update notification' check-box.
    • If you don't want the normal notification email to be sent, leave the 'Send update notification' check-box blank.
      Note that the issue's Change History will always be updated when a label is added.
  5. Click the 'Update' button. Your new label will be saved.

You can also add a label when you create or edit an issue.

Removing a label from an issue

  1. View the issue which you want to label.
  2. Click the 'edit' icon which appears to the right of the word 'Labels':
  3. In the pop-up dialog box that appears, click the 'x' that appears to the right of the label that you wish to remove.
  4. Normally when you edit and save an issue, certain people are notified via email.
    • If you want the normal notification email to be sent, select the 'Send update notification' check-box.
    • If you don't want the normal notification email to be sent, leave the 'Send update notification' check-box blank.
      Note that the issue's Change History will always be updated when a label is removed.
  5. Click the 'Update' button. Your change will be saved.

You can also remove a label when you edit an issue.

See also


Document generated by Confluence on Mar 27, 2011 18:27