Custom events sources

Custom events sources

Custom Events sources allow you to display and manage events that are not based on Jira issues, sprints, versions, or worklogs.

Custom sources can be based on either default event types or custom-defined event types created by an administrator.

What you can do with Custom sources

  • Display custom events on the calendar

  • Use default or custom-defined event types

  • Create and manage events directly from the calendar

  • Configure displayed fields and event details

  • Customize event appearance and colors

  • Apply conditional colors based on event data

  • Control event overlap using concurrence rules

  • Receive email notifications for custom events

  • Define default event summaries


Available Event types

The following event types are available by default:

  • Business Trips

  • Meetings

  • Sick Days

  • Vacations and Leaves

  • Planning

Add Custom source

  1. Open Calendar Configuration.

  2. Navigate to Sources.

  3. Select Custom and press Add Event Source.

  4. Enter a source name.

  5. Populate required fields

  6. Save the configuration.

chrome_O9AYpPogjK-20260623-123344.gif

 

chrome_O9AYpPogjK-20260623-123344.gif

 

When a Custom Events source is added, the source name is automatically populated with the selected event type name.

Manage Event sources

Filter which issues appear

You can configure Project availability for custom events:

  • All Projects – Users can link events to issues from any Jira project.

  • Specific Project – Users can link events only to issues from the selected project.

  • No Project – Events are not linked to Jira projects or Jira issues.

This setting controls which Jira issues can be associated with events created from this source.

image-20260623-124156.png

 

image-20260623-124156.png

 

Configure event display

Under Issue Fields, select which Jira fields are displayed on events and in the event details dialog.

Option

Description

Option

Description

e

Display on the event block

i

Display in the information dialog

You can add, remove, and reorder fields to customize how event information is presented throughout the calendar.

image-20260618-103347.png

 

image-20260618-103347.png

 

Advanced Features

The Advanced tab provides additional options for customizing the behavior and appearance of events created from a Custom Events source.

  • Conditional colors - Automatically apply different colors based on issue field values or conditions.

  • Email notifications - Receive notifications about Jira-based calendar events when email notifications are enabled globally by an administrator.

  • Default summary - Define the default title format for newly created issues.

  • Concurrence rules - Control how overlapping events are displayed and managed.

  • Start time display - Enable Display start time to show the event start time directly on event blocks in Calendar view.

image-20260618-103633.png

 

image-20260618-103633.png

 

Conditional colors

Conditional colors allow you to automatically apply different colors to events based on configured conditions.

In addition, when it comes to custom events, you’ll be able to create the conditional colors that are based on custom fields such as Event Project, Event Description, Event User(s), Event Reporter, and Event Summary fields.

For detailed information about configuring conditional color rules, see Conditional Colors.

image-20260618-111013.png

 

image-20260618-111013.png

 

Email notifications

Email notifications can be enabled for events created from this source when email notifications are globally enabled in the application configuration.

When enabled, users receive notifications related to event creation and updates.

Default summary

The Default Summary option controls the default event title used when creating new events.

Available options:

  • None – no default summary is applied.

  • Source Name – use the source name as the event summary.

  • Issue Summary – use the linked issue summary as the event summary.

Concurrence rules

Concurrence rules determine whether events created from this source are allowed to overlap.

Available options:

  • Allow concurrent events – multiple events can overlap.

  • Don't allow concurrent events – overlapping events are not allowed.

  • Don't allow concurrent events on event's user level – overlapping events are allowed only when assigned to different users.

  • Block concurrent events on the same issue – users cannot create overlapping events that are associated

Note: Concurrence rules do not apply to recurrent events.