Use Cases

Jira issues have many date information, for instance Created date, Resolution date, Due date, Date / Datetime custom fields, etc.

Those are the reasons why we have built Issue Events and Issue Calendars.

This documentation refers to specific and advanced settings of Issue Calendars. Refer to the Timeline Core Concepts page if you are not familiar with basic concepts and features of Calendars.

Setup an Issue Calendar

In the Events Source tab, choose which Issues you want to show on the Timeline. Using the toggle on the top right corner, you can switch between Basic and Advanced modes.

Basic Mode

In the first section, select a Jira Project and the Issue Type. In the second section, map the Calendar Events start date, end date and Environment with your Issue Type Fields.

Advanced Mode

With the advanced mode, choose a Jira Project, an existing Jira Filter or write your own JQL query.

Then, in order for the Events to appear on your Timeline, you have to choose the issue fields corresponding to the start of the event, the end of the event and the linked Environment.

Finally, you can define Default Values for the Project and the Issue Type, that will be populated automatically when you will create issue from the Timeline, using drag-and-drop.

Events Source - Advanced Mode

Customize displayed event information

Your Calendar Events' layout is fully customizable. You can choose which information to display in the following 3 different areas:

To change the view options, open the Calendar Details Panel of an Issue Calendar and open the Displayed Information section:

  1. Choose which field should be displayed in each of the 3 different areas

  2. Re-order fields with drag and drop

  3. Click on Done button to apply your changes

Only fields with non empty values will be shown in Title and Tags areas. Fields added to Details will be only visible in the dialog opened when clicking an event on the timeline.

Create an Issue Event

To trigger the creation of a new Event, you can either:

  • Click on the plus button next to the Calendar

  • Drag and drop the plus button of a Calendar onto the Timeline

  • Select a Calendar, open its dropdown and select “Add Event”

Create a new Event with Drag & Drop

Create issue screen opens

You must have Jira permissions to create new issues.

Resize and Move an Issue Event

  • Select and drag start/end of an Issue Event to change its start/end date

  • Select and click in the middle of an event to move it

You must have Jira permissions to edit the selected issue.

Edit an Issue Event

To edit an Issue Event (belonging to an Issue Calendar) you can either:

  • double click on it

  • select it and click on Edit button on the Event dialog

Edition of an Issue Event will open the standard Jira "Edit Issue" dialog.

You must have Jira permissions to edit the selected issue.

Delete an Issue Event

To delete an Issue Event (belonging to an Issue Calendar):

  1. Select the Event you want to delete

  2. Click on the Browse button to open the Jira issue page

  3. Delete the Jira issue (if you have permission for it)

You must have Jira permissions to delete the selected issue.