Use Epic Color for Epics in Jira Cloud

Platform Notice: Cloud Only - This article only applies to Atlassian products on the cloud platform.

Summary

Jira offers a custom text field named Epic Color which can be used to visually distinguish Epics from one another in board, backlog, and issue search experiences.

Solution

Add the Epic Color field to your project's screen(s)

Similar to any other field, Epic Color can be added to a project's field scheme in Jira settings > issues > custom fields.

Epic Color includes 14 pre-set colors. To change your Epic's color with this field, click the colored square next to the issue title and choose from the available options.

The Epics panel in a scrum or Kanban board of a company-managed project also allows you to select a color in the same way.

Search for Epics based on their Epic Color

The choices for Epic Color do have descriptive names associated with them, for example, "dark gray" or "teal." However, Jira does not allow searching for Epics based on this naming convention. Instead, you must search based on the text code associated with each Epic Color option. The text code begins with ghx-label- and is followed by an integer ranging from 1 to 14.

For instance, assume you have selected "teal" as my Epic Color. If you want to search for this Epic and other Epics using the same color, your JQL search would look like this:

"Epic Color" = ghx-label-11

List of available Epic Colors and searchable codes

Color Name (not searchable)

HEX code

Code

dark gray

#243859

ghx-label-1

dark yellow

#FA9920

ghx-label-2

yellow

#FAC304

ghx-label-3

dark blue

#2A53CC

ghx-label-4

dark teal

#2AA3BF

ghx-label-5

green

#58D8A4

ghx-label-6

purple

#8677D9

ghx-label-7

dark purple

#5244AA

ghx-label-8

orange

#FA7353

ghx-label-9

blue

#3884FF

ghx-label-10

teal

#34C7E6

ghx-label-11

gray

#6B778C

ghx-label-12

dark green

#128759

ghx-label-13

dark orange

#DD350D

ghx-label-14

Updated on April 8, 2025

Still need help?

The Atlassian Community is here for you.