Conditional colors

Did you know that you can apply conditional colors to the events created based on Jira dates sources?

The conditional colors can be applied to a Jira dates source by opening its configuration and switching to the Advanced tab.

Users can customize both background and font colors for event sources and their conditional colors, providing greater flexibility and improved visual clarity.

The color selected for an event’s background or text font for a given condition can be easily reused across multiple event sources on a calendar by copying the HEX code.

To create a conditional color, all you have to do is to select the field and operator. Then, either select another field or insert a value. Please see the examples of conditional colors below.

Once the field, operator and value/field are selected, make sure to click the blue Plus button to add the created conditional color.

Please don’t forget to save the changes to a source configuration by clicking the Save button

In case multiple conditional colors are added to a Jira dates source, and an event complies with more than one requirement, the topmost matching condition is applied.

The created conditional colors can be rearranged by using drag-and-drop.

Functions

For such fields as Due date, Updated, Created, etc., the conditional colors can be created, using functions. The list of function suggestions will be shown in a drop-down menu:

For example, you want the events that are based on Jira issues that are due by the end of the day to be highlighted in bright green. In such case, you will create the conditional color based on the field Due date, operator <= and the function endOfDay() as shown below:

The selected function can be modified to suit your business needs. For instance, you want to highlight the events that are based on Jira issues that are due by the end of the next week. In such case, you will use the function endOfWeek(). Then, you will have to edit it by inserting “1“ inside the parentheses so it is endOfWeek(1). With other words, you are, simply, adding one week to the standard function “by the end of this week“.

If needed, you can use the functions with increments d (days) or w (weeks). For instance, endOfWeek(1d), endOfMonth(-1w).

Operators

The operator in is supported by the conditional colors. To use the operator in, first, select the field. Then, the operator in. Then, type in the value and click it in the list of suggestions. In case you want to add multiple values, type in and click each value, one at a time, as shown below:

If you want a conditional color to apply when at least one value from a list is present in a field, use the in operator. This is useful for multi-value fields such as Labels, Components, or Fix versions.

For example, to highlight events with any of the labels apple, tree, or cloud, set the condition as:
Labels in apple, tree, cloud

Imagine there are three events on a calendar:

One with label apple
One with labels leaves and tree
One with labels apple, tree, and cloud

The conditional color will be applied to all three events, since each has at least one of the listed labels.

In contrast, if you use the = operator (e.g., Labels = apple, tree, cloud), the color will only apply to events that contain all of those labels.

Editing conditional colors

To edit a conditional color click on Pencil icon next to it.

Once you are done editing the conditional color, click the Checkmark button to close the editing mode.

Once you exited the editing mode, please don’t forget to click Save button to save the latest changes made.