Color Labels

Field Configuration

Before starting the field configuration, please follow the instructions for creating custom fields

Step 1: Set a name and description

Provide a good name for the new custom field. Make it descriptive, concise, and easy to understand for others who will use it. Avoid using ambiguous or overly technical terms.

Step 2: Configure your custom field

The field allows you to choose from a pre-defined color palette. Easily choose a color, enter a name for the label and press the “+”.

Step 3 (Optional): Set order

Specify whether the color labels should be sorted alphabetically, by color, or both.

This setting affects the issue view and the field edit dialog. If no order is specified, labels will be sorted by creation date or in the order of adding labels as field value.

Note that this setting does not apply to the issue navigator view.

Field view and edit

Edit view

You may filter by color or by label name

Issue view

Click the label to view all related issues.

Related Use Cases

More use cases are coming soon. In the meantime, check out our other use cases.

Jira Service Management (JSM)

Before you can add a custom field for Jira Service Management (JSM) projects, you first need to setup the custom field: Color Labels | Field Configuration. Then follow the guide to use the field in the request form or the portal view: Add Custom Fields to Jira Service Management.

Request form

Portal view

JQL expression

${fieldName}.Text: string[]
${fieldName}.Color: string[]

Find further information here Find specific work items | Jira Cloud | Atlassian Support

Example: a search for all issues with label text “Approved“

"Color Labels.Text" = Approved

Data structure (automation)

Use custom fields with automation

To set the value via automation, you need the following object structure

{
  "texts": string[],
  "colors": string[]
}

Example for a green label with the text “Approved“ and a red one with text “Rejected“.

{
  "texts": ["Approved", "Rejected"],
  "colors": ["green", "red"]
}

Please note that the order of texts and colors is important! Also you can only choose previously configured text/color combinations .