What is a Timeline?
A Timeline is a display of a list of events in chronological order. These events are provided by calendars. A calendar is a source of events.
You navigate a timeline by adjusting its visible date range. You can group events (by environment, category, calendar,…) using horizontal swimlanes.
Different types of calendars will provide different types of events.
Swimlanes: manage how Events should be grouped into Swimlanes
Calendars: manage type of Calendars & Events should be displayed on current timeline
Time Navigator: scroll to next/previous period or to jump to a specific date
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 a Timeline
Open a Timelines Pages and click on ”Design a Timeline” menu item in the View Browser, in order to create a new timeline:
Select "Timeline" category:
Select the template you want to start from to create your new timeline
Select "Project Issues" template
Select Jira Project and Issue Types you want to add to your new Timeline:
Click on "Create" and a Timeline with pre-defined Issue Calendars will be automatically created:
Select "Blank Timeline" template
Click on "Add Calendar" to start adding events to your new timeline:
Create & Schedule Events
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.
All calendars of your Timeline are managed in the Calendar Panel:
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
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)
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!
Timelines are either private or shared with other Jira users and you can manage your Timelines from the Manage Views Page. Important Timelines can be added in the Global or Project Views section so that other team members can easily access them.
Once saved, you can also publish a Timeline on a Jira dashboard using the Timeline Gadgets.
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: