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

Why 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 a Timeline

Open a Golive Page and click on ”Create View” 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

Project Timeline

  1. Select "Project Issues" template

  2. Select Jira Project and Issue Types you want to add to your new Timeline:

  3. Click on "Create" and a Timeline with pre-defined Issue Calendars will be automatically created:

Blank Timeline

  1. Select "Blank Timeline" template

  2. Click on "Add Calendar" to start adding events to your new timeline:

Add calendars:

You need at least the permission to view a Calendar in order to add it to a Timeline.

You need at least “Create Calendars” global permission in order to create new Calendars. For more information: Security & Permissions

Setup of a new Calendar is specific to its Calendar Type.

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.

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.

Calendars Panel

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:

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

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. 1.VIEW: authorized users can see events and use your Calendar for their Timelines in read-only mode

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

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

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

  5. 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. These global permissions are stronger than permissions defined at Calendar level.

Why Swimlanes?

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.

Use Swimlanes

Once you have added at least 1 calendar, you can customize your Timeline:

You can drag and drop swimlanes to sort them manually.

Swimlanes Settings

Click on the Swimlane column title to set Swimlane options:

Filter Swimlanes

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!

Display Settings

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

  • JSON (JavaScript Object Notation) files, a lightweight format for storing and transporting data

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: