Time in Status (Forge) for Jira Cloud- What is a Calendar Select field?
- Creating the field
- Context configuration
- How it works with other fields
- Using the field on issues
- JQL search
- Tips
What is a Calendar Select field?
A Calendar Select field is an editable custom field that lets users choose a work calendar for a specific issue. When selected, this calendar overrides the default calendar configured in field settings for that issue.
This is useful when different issues need different work schedules. For example:
- An international support team where issues from different regions follow different business hours
- Projects where some issues follow a 24x7 schedule and others follow business hours
- VIP customers with extended support hours
Creating the field
- Go to Jira Settings > Issues > Custom fields
- Click Create custom field
- Select Calendar Select from the field type list
- Enter a name (e.g., “Work Calendar”, “SLA Calendar”)
- Choose the field context
- Click Create
Context configuration
Each field context for Calendar Select has its own configuration:
- Go to Jira Settings > Issues > Custom fields
- Find your Calendar Select field > Contexts and default value
- Click on the context name
- Configure:
| Setting | Description |
|---|---|
| Available Calendars | Which calendars users can choose from. Select specific calendars or leave empty for all calendars. |
| Default Calendar | The calendar pre-selected for new issues. Optional. |
How it works with other fields
Calendar Select integrates with Time in Status, Stopwatch, Timer, and Time Between Dates fields through the Calendar Field setting.
To connect them:
- Open the field setting for your TIS/Stopwatch/Timer/TBD field
- Set Calendar Field to your Calendar Select field
- Save
Now, when an issue has a Calendar Select value, that calendar will be used instead of the field setting’s default calendar for time calculations on that issue.
Calendar priority
When calculating time, the app checks calendars in this order (highest priority first):
- Calendar Overrides (JQL-based, Stopwatch/Timer only) - first matching JQL
- Calendar Select field value on the issue
- Default Calendar from the field setting
Using the field on issues
Users with edit permissions can set the calendar on any issue where the field is available:
- Open the issue
- Find the Calendar Select field
- Click to open the dropdown
- Select a calendar from the list
JQL search
Calendar Select fields have two searchable properties:
| Property | Type | Description |
|---|---|---|
| CalendarId | text | The internal ID of the selected calendar |
| CalendarName | text | The display name of the selected calendar |
Examples
"Work Calendar[CalendarName]" = "Business Hours"
"Work Calendar[CalendarName]" = "24x7 Support"
Tips
- Not all issues need a value: Calendar Select is optional. Issues without a value simply use the default calendar from the field setting.
- Rename calendars carefully: if you rename a calendar, the CalendarName search property updates on the next recalculation.
- One field, many uses: the same Calendar Select field can be referenced by multiple TIS/Stopwatch/Timer/TBD field settings.
