Documentation for JIRA 4.4. Documentation for other versions of JIRA is available too.

Skip to end of metadata
Go to start of metadata

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. You can then search for issues that have been given a particular label.

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 in GreenHopper Classic.

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 or press the cursor-down key to select from a list of suggestions.

      (info) 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.
      (info) 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.

(info) 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.
      (info) 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.

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

See also