• The roadmap timeline will display all Epic Issue on the project* that has been enabled
  • The roadmap will display the Summary of the Epic Issues by default.
    • The Epic Name will be displayed in a tooltip above the Summary.
  • By default, the timeline will display:
    • The last year
    • The current year
    • The next year
  • You can change the order of the Epis Issues by simple drag and drop
• Each Epic has a bar, representing a date range. The date range will have your configured fields as Start and End date.
  • If an epic doesn't have a set start or end date, the ends of the horizontal bar will appear rounded. 
  • If no start date is set, the epic will automatically begin on the day the first issue was added.
  • If no end date is set, the epic will automatically end one month from the day it was created.
• You can change the date range easily
  • Hover on an epic to view its date range
  • Drag its left and right edges to adjust the date range
  • Drag the bar and move it left or right to change the date range
• Bars and their dates will become more transparent once their due date has passed.
• You can manage your Epic bars on Quarterly, Monthly and Weekly timeline view
• You can navigate forward and backward on the timeline using the slider. Use the Today button to navigate to the current date.

 *The roadmap displays up to the first 1000 Epic Issues based on the Created Date. If your project contains more than a thousand Epics, we recommend filtering them down.

Date range filter

You can set the displayed timeline for the Epic Issues with the date range picker 

• Select the desired start date and end date for the timeline
• By default, the timeline will display: the last year, the current year, the next year
• Click on the "Reset filter" button to set the timeline to the default view

Status filter

You can filter the Epic Issues on the roadmap based on its' statuses. 

• Select the desired statuses and the roadmap will only display the Epics in the selected status.
• Select the statuses again to remove them from the filter.
• Click on the "Reset filter" button to quickly remove all selected statuses.

View Options

You can display additional information about the Epics on the timeline with the Options button:

• Show Status
• Show Dates
• Show Progress
• Show Issue Key
• Show Dependencies
• Show Markers

Show Status

If this option is checked, the statues of the Epics will be displayed on the timeline next to their summary.

Show Dates

If this option is checked, the Start and End dates of the Epics will always be visible on the timeline next to the bars.

Show Progress

If this option is checked, the progress of the Epics will be visible below the Epic Summary.

You can track progress towards Epic completion with the progress bar. It will be calculated based on the status category (to do, in progress, complete) of the Issue in Epic in workflows.

Show Issue Key

If this option is checked, the Issue Key of the Epics will be visible next to their Summary.

The interface will display who and when changed something last on the roadmap. (eg.: order, start date, due date)

 This timestamp will not reflect if an epic was updated somewhere else, like on the Issue screen or on any board.

You can manage date markers to represent milestones or releases.

• You can add, edit or remove custom date or version marker on the roadmap.
• The name and the date will be displayed in a tooltip over the marker.

You can add custom date markers to represent milestones or events.

1. Click on the "Add marker" button.
2. Select "Milestone marker" tab
3. Provide the name of the marker
4. Select the date of the marker
5. Select the color of the marker
6. Click on "Add marker" button

You can add versions as markers to the roadmap. The marker will represent the verion's release date.

1. Click on the "Add marker" button.
2. Select "Version marker" tab
3. Select the version
4. Select the color of the marker
5. Click on "Add marker" button

You can also remove the version markers from the roadmap here.

You can visualize dependencies between epics

The Issue link between two Epics will be represented as a line on the Roadmap timeline. You can view the issue link type's name on the line, eg.: Blocks, Clones, etc. With the help of the dependency lines, you can view if one epic is blocking the progress of another, or two epics that impact one another.

The starting point of the lines depends on whether the links are configured as an outward or inward link. The outward link is always to the right of the bar and the inward is always to the left.

 The line will turn red if the Epic Issues' dates overlap.

View details about the dependencies

Click on the dependency name to view:

• The Epic Issue and its' due date of the outward-bound Epic
• The Epic Issue and its' start date of the inward-bound Epic
• The outward link's name between the two Epic

 The line will turn red if the Epic Issues' dates overlap.

To create an Epic Issue, click the + below the Epics in the first column.

• The Summary and the Epic name value of the newly created Epic Issue will be the provided text.
• Issue Type will be Epic.
• Start Date will be the date where the timeline is currently positioned.
• End Date won't be initialized.

 Note:

• Epic Issue will be created regarding your workflow and project settings (status, etc.)
• If there are required fields in your Create ISsue Screen, the app won't be able to create the Epic from the timeline view. In this case, you should create the Epic Issue on the default Jira Create Issue Screen.

Epic bars on the roadmap will be in the same color as in your Agile project.

To change the color of the Epic, follow the Atlassian guide in case of:

• Kanban project
• Scrum project

Click on the Epic to view it in more detail. On this view the following fields can be displayed and edited:

• Issue Key
• Summary
• Status (not editable)
• Epic Name
• Start Date (the configured date field in roadmap settings)
• Due Date (the configured date field in roadmap settings)
• Components
• Labels
• Affect versions(s)
• Fixed versions(s)
• Reporter
• Assignee
• Description
• Issues in Epic
• Linked Issues
• Activity
  • Comment
  • Work Log
  • History

 These fields will be present in the details view only if they are visible (not hidden) in the project's Field Configuration.

 These fields will be editable on this view only if they are on the Edit Issue screen.

Create Epic Link

You can view and add Epic link to Issues.

1. Click on the + icon
2. Select the Issue for the Epic Link
3. Press "Link" button to save it

You can also remove the link by clicking on the X icon on the right side of the Issue.

Create Issue Link

You can view and link other Issues to the selected Epic.

1. Click on the + icon
2. Select the link type
3. Select the Issue for linking
4. Press "Link" button to save it

You can also remove the link by clicking on the X icon on the right side of the Issue.

You can export your timeline to a PNG image with the Export button. The exported image will contain:

• the timeline and Epics in the selected date interval
• all information that you selected in the Options (markers, dates, etc.)