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.
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.
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 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:
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:
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:
VIEW: authorized users can see events and use your Calendar for their Timelines in read-only mode
PLAN OWN: authorized users can add/remove/edit Events they created themselves
PLAN: authorized users can add/remove/edit Events of your Calendars
EDIT: authorized users can change settings of your Calendar except permissions
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.