Project Administration - Label Manager

Owned by Wolfgang Landes (Deactivated)
Last updated: Aug 13, 2022 by codecentric AG
4 min read

Label Manager Custom Fields can only be created by an Jira-Administrator. The Create button only redirects to the global custom field overview.

Label Manager - Project Settings Page

  1. As Project Administrator: Jira project → Project Settings → Apps → 'Label Manager - Project Settings'

  2. Select the Label Manager custom field you want to configure → Click Select


 

2. Switching from global settings to project specific settings

 

  • All label manager custom fields use the global label items by default.

  • You have the option to switch to project specific label which allows you to change the label items used in your project indipendent from global changes.

If you once started to work with Label Manager fields for example with global items and you have one or more issues assigned with these items, it can happen that you want to switch to local Label Manager settings for your project.

  1. Select “Customize for project <projectKey>”

  2. Click “Submit General Settings”

  3. In the modal-dialog you need to decide if you want to copy the global items or start with an empty list and delete already selected label items. Click Copy or Delete

 

Switching from project settings back to global specific settings

If you once worked with Label Manager items with local settings in your project and you want to switch back it's only possible to maintain the items selected that also exist in the global settings. To do this, select ‘Maintain’ while switching from project specific to global settings.

If you want to delete selected labels in the project click ‘Delete’

The reason for deselecting or migrating the items is that Label Manager custom fields do only allow items assigned to your issues which are defined in your settings.

3. Label Color Settings

Decide on what label color settings you want to use within the projects.

Please check theLabel Colordocumentation on Label Color Options for more details.

4. Add Project specific label item(s)

Once you decided to customize the label items for your project you get a similar input and table as in global settings to add and update label items.

  1. Add one or multiple label at once using the text input field: Add label item(s)

Use a comma and space seperated list to add multiple label items at once. Example:

label1, label2, label3

5. Filter, Edit, Merge and Delete - Project specific Label Items

  • Updating project specific Label Items will update the label item on every issue that it is selected inside the project.

  • This will trigger the “Update Issue” event and Jira will sent Emails based on Notification settings.

  • The updating task may continue in the background if too many issues (>1000) need to be updated.

Filter Project specific Label Items

Use the free text search field to filter the displayed label items.

The search is case insensitive and fuzzy and will return labels even if you only search for parts of the label.

This should help you finding related labels, duplicates, typos.

Example

Search text: ‘label’ will return ‘Label-Manager’, ‘lable’ and 'Lale

 

Rename Project specific Label Item

  1. In the table, identify which label to edit and click Rename

  2. In the modal-dialog edit the label and click Submit

Merge Project specific Label Items

  1. In the table identify the label you want to merge into another one and click Merge

  2. In the modal-dialog select the label you want to merge into and click Submit


Delete Project specific Label Items

  1. In the table, identify the label you want to delete and click Delete

  2. In the modal-dialog, confirm the deletion which will remove the label item as selectable option as well as remove the label from any issue it is currently selected inside the project. Click Delete