Skip to main content
Skip table of contents

Working with Events & Calendars


What is an Event?

An event is something that begins at a given start date and finishes at a given end date.
An event without end date is a milestone and has no duration.

Each event is owned by a calendar. You can create, edit and view events on timelines.

You can customize the name, the dates, the description and the color of each event.

Each type of event provides additional information and settings.


What is a Calendar?

A calendar is a source of events.

You can customize the name, the color and the permissions of each calendar.

Each calendar type provides additional settings to customize the retrieval and rendering of its events.


Why using Calendars?

When you start scheduling Deployment, Releases, UAT, Changes, etc. or performing Post Implementation Reviews, you are quickly dealing with a high number of Events.

Calendars allows you to group these Events by themes/types, for instance Data Refresh, UAT, Infra Changes, Deployment, etc.

You can create as many Calendars as you need and add them (and their Events) to your Timelines.


Create & Schedule Events

Choose a calendar to create a new event:

You will see the "plus" button if you have enough permissions and if the selected calendar type supports the creation and edition of events.


Time Navigation

You can navigate time and change the visible date range of current Timeline using your mouse, trackpad or using the timeline toolbar:

Check Timeline Date Range Settings to learn how to automatically set the visible date range relatively to current time.


Filter Events

Filter your Timeline Events using the filter button:

More filtering options are available using the “More” button.

For reusing a filter, save it as a Quick Filter with the “Save as” button and choose a name:

Quick Filters are available from the “Quick filters” button. Activate/deactivate one or many quick filters at a time by clicking on them. Active Quick Filters have a dark blue background.

Update Quick Filters by clicking on the small gear that appears when your cursor is on the Quick Filter:


Calendars Panel

All calendars of your Timeline are managed in the Calendar Panel:

Calendar Details Dialog

Edit a Calendar

Click on a Calendar in the Calendars Panel to open the Calendar Details dialog:

If you cannot change settings of a given Calendar you may not have sufficient permissions.

Specific settings for different types of calendars:

Share a Calendar

When you create a calendar, it is only visible in its current timeline. In order to re-use a calendar in multiple timelines, you have to share it. In order to do that, you have to click on the Share icon on the top of the calendar panel:

Shared calendars have a specific "shared" icon in the calendar list. Click this "shared" icon to access the sharing options of the selected calendar:

You must have "Manage Calendars" or "Create Shared Calendar" global permission in order to share calendars. Check Security & Permissions

Set Calendar Permissions

You can manage Calendar permissions by clicking the "locker" button that appears on the top of the Calendar Details dialog:

Owner and Administrators of a Calendar, can grant 4 types of permissions to Jira users and groups:

  1. VIEW: authorized users can see events and use your Calendar for their Timelines in read-only mode

  2. PLAN OWN: authorized users can add/remove/edit Events they created themselves

  3. PLAN: authorized users can add/remove/edit Events of your Calendars

  4. EDIT: authorized users can change settings of your Calendar except permissions

  5. ADMIN: authorized users can set permissions of the Calendar and delete it (full control over the calendar)

Jira users with global Manage Calendars or Apwide Administrators permissions can view and manage all Calendars without restriction. Also, Jira users with global Plan Events permissions can plan events from all Calendars without restriction.

These global permissions are stronger than permissions defined at Calendar level.

Use Case Example

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.