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
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. These global permissions are stronger than permissions defined at Calendar level.
You can greatly improve readability of a Timeline by grouping its displayed Events.
For example, you may want to see Events planned for each Environment into separate lines (one per Environment) in order to know when an Environment is available.
These horizontal groups of Events are called Swimlanes. Events can be grouped by different types of Swimlanes.
Once you have added at least 1 calendar, you can customize your Timeline:
You can drag and drop swimlanes to sort them manually.
Click on the Swimlane column title to set Swimlane options:
Click on filter button to set Swimlanes filtering & sorting options:
Date Range Settings
You can change the default Date Range settings from here:
Fixed vs Relative Date Range
By default, the visible time range of a Timeline is defined by a fixed start date and a fixed end date:
Sometimes, you may want the visible time range to be automatically adjusted based on current date/time. For example, you may need a Timeline that will have a default visible range starting 1 month in the past and ending 3 months in the future.
In order to do that, you must activate the Relative Date Range toggle (of the Date Range section) and define how Golive should adjust the start/end dates:
You specify the timeframe position by defining which period of time must be displayed before and after current time. For example, to display a timeframe including the last 2 weeks and the next 2 weeks, you can configure a start at '-2w' and an end to '2w'.
All available Jira duration expressions can be used:
y : years
M : months
d : days
h : hours
You can also display a timeframe completely in the past or in the future, for example the 2 next weeks after the current week would start at '1w' and end at '3w'.
Combined with the Timeline Gadget, you can use these relative time ranges to setup auto refreshed Jira dashboards: your dashboards will automatically adjust their data range and display always up-to-date events!
You can change the display settings of a Timeline using the Settings menu:
From there you can change the general display options of your Timeline:
The Automatic orientation option automatically rotate vertically the content of your events if it cannot be fully displayed horizontally
The Font size option lets you choose the size of fonts used on the Timeline
With the Time Markers option, you can show or hide the vertical lines for Milestones:
Save & Share a Timeline
When you are done, don't forget to save your Timeline!
Once saved, you can also publish a Timeline on a Jira dashboard using the Timeline Gadget.
Export in XLSX, CSV, JSON
You can export Timeline Events in different formats:
XLSX files that can be opened by Microsoft Excel version 2007 and later
CSV (comma-separated values) files that can be opened by programs storing data in tables, such as Microsoft Excel or OpenOffice Calc
First of all, ensure that all the Events you want to export are visible on the Timeline.
Then, click on the Export button and select XLSX, CSV or JSON files:
Example of XLSX export
Example of CSV export
Example of JSON export
iCal export to Outlook, Gmail, Team Calendar...
You can export Environment Events and Logs (Deployments and Status Changes) to Outlook, Gmail, iCalendar, iOS Calendar, etc.
Click on the Export button and on “New iCal feed”:
In order to generate a new link, complete the required information and click on the Create button:
You can create as many export as you need. It will allow you to visualize Events into your favorite calendar app without having to connect to Jira. You can also visualize Events in Confluence using “Team Calendar”.
Only calendars that are shared with "Anyone" can be exported to iCal feeds (refer to Calendar Permissions).
iCal export is not supported by all types of Calendar.
Learn how to subscribe to iCal feeds from some popular calendar apps: