Conditional Colors configuration
Conditional colors allow you to automatically change event colors based on specific Jira field values or conditions. This helps highlight important events and makes calendar data easier to understand at a glance.
To configure conditional colors, open the source configuration and navigate to the Advanced tab.
Create a Conditional Color
To create a conditional color rule:
Select a field.
Select an operator.
Enter a value or select another field.
Choose the desired background and text colors.
Click the + button to add the rule.
Save the source configuration.
|
|---|
When multiple conditional color rules match the same event, the first matching rule in the list is applied.
Conditional color rules can be reordered using drag-and-drop.
Functions
For date and date-time fields such as Due Date, Created, or Updated, you can use Jira date functions when defining conditions.
Available functions are displayed automatically as suggestions.
Example: Highlight Issues Due Today
To highlight events based on issues due by the end of the current day:
Field: Due Date
Operator: <=
Value: endOfDay()
|
|---|
Example: Highlight Issues Due Next Week
Functions can be adjusted by adding offsets.
For example:
endOfWeek() – end of the current week
endOfWeek(1) – end of next week
endOfMonth(-1) – end of the previous month
You can also use day (d) and week (w) increments:
endOfWeek(1d)
endOfMonth(-1w).
|
|---|
Using the "in" Operator
The in operator allows you to match any value from a list.
This is especially useful for multi-value fields such as: Labels, Components, Fix Versions
To use the operator:
Select a field.
Select in as the operator.
Add one or more values from the suggestion list.
Example
To highlight events that contain any of the following labels:
Labels in Red, Green, YellowThe conditional color will be applied if at least one of the specified labels is present.
In contrast, using:
Labels = Red, Green, Yellowrequires all listed values to be present before the condition matches.
|
|---|
Editing conditional colors
To edit an existing rule, click the Edit (pencil) icon.
After making changes, click the Checkmark icon to exit edit mode.
Once you finish editing, save the source configuration to apply the changes.
|
|---|