Colors for Jira extends Structure with two additional columns: Color Key and Color Bar. It also patches Structure's standard Key column to make it behave correctly as the Color Key column.

 

This article applies to Colors for Jira version 2.0.0 and above.


Adding a column

Structure users can add Colors for Jira columns using the Add Columns button.

Color Key column

This column displays the issue key and adds a small colored tag around it, based on the assigned Color Scheme. Users can configure several Color Key columns, and each column can be assigned to a separate Color Scheme. 

This column applies only to issue rows of the structure. It does not show any data in non-issue rows (folders, memos, etc.).

Inaccuracy warning

Structure caches data for performance purposes. The caches are updated as issues change, so in most cases users see current data in Structure. However, some JQL queries may contain statements that depend on something other than issue field values - when color schemes are assigned based on these types of JQL queries, they may not update until a change is made to the issue that will trigger an update of its cached data.

For example, the standard Overdue color scheme depends on time (duedate() < now()), so issues colored by this rule may remain unchanged as time passes.

When the column detects that the selected color scheme may result in colors not being updated if issues are not modified, it shows the "May be inaccurate" warning.

You can clear cached values by hard-refreshing your browser. On Windows systems this is typically Ctrl+f5, on Mac Cmd+Shift+R

Color Bar column

This column aggregates issue colors for the entire subtree and displays it as a color bar. The length of a color fragment in the bar is proportional to the total number of issues of the same color in the subtree.

Note: The subtree root issue is treated as a member of the subtree and its color is taken into account too.

Count non-matched issues

The Include non-matching sub-issues checkbox allows the user to control how issues that do not match any coloring rule are counted.

Count only colored issuesCount non-colored issues as well

PP-3 (second row) has no Color Bar, and is not counted in its parent (PP-1) color bar.PP-3 (second row) has grey Color Bar, and is counted in its parent (PP-1) color bar.

When the check box is not checked, only issues which satisfy at least one coloring rule are counted. Thus, the non-colored issues are not counted, as if they do not exist in the sub tree. The Color Bar column does not show the empty bar for these issues either.