Roadmaps
Communicate your plans with stakeholders and customers.
Overview
Create internal or customer-facing roadmap views directly from your Jira issues. Customize the view by selecting the fields to display and adding detailed descriptions of your plans. Since the data is stored on the issue, your view will always be up to date.
Use-cases
Use Roadmap views to communicate plans to customers or stakeholders. Released roadmaps are highly flexible and can work across projects, enabling you to consolidate work from various teams as needed.
Released roadmaps are perfect for:
Public roadmaps
High touch customer communication
Stakeholder updates
Basics
Linked projects
Roadmap views can display issues from multiple Jira projects. To include issues from a specific project on your roadmap, simply add that project to the linked projects within the space.
Filter
Use filters to refine the issues displayed on the roadmap. You can apply basic filters such as issue type or labels, or utilize JQL for more advanced filtering options.
Column mapping
Map issues to columns on the roadmap based on their status or field options. This can include criteria such as teams, quarters, priority, and more.
To customize the column mapping:
Select Display options.
Click Edit columns.
Select the field you want to map for each project.
Map your field options by dragging them to the corresponding column.
Field configuration
Released roadmaps support a variety of custom field types that can be displayed on the card or in the detail view.
To add a field to the view, click the + icon next to the field names in the Available Fields section. By default, the field will appear on both the compact card on the board and the detailed (dialog) view. Use the checkboxes to show or hide fields in each respective view.
Title
The issue Summary field will be used as the default title. The title field is always displayed on both the board and the detailed view and cannot be unchecked. To change the title field, click the T icon next to any compatible text field.
Public description
The public description is a special system field that can only be edited within a Released board. It leverages the same rich-text editor as the changelog, allowing you to easily embed images and videos (like Youtube and Loom). In the board view, the public description is automatically truncated. To display an alternative description, you can hide the public description field and show a short text field instead.
Field ordering
You can adjust the order in which fields are displayed on the card and in the detail view by dragging and dropping the fields in the list. Note that the order of the title and description field can not be changed.
Available field types
Status
Labels
Date / Time-date
Select
Multi-select
Issue type
Checkboxes
Radio Buttons
Editing the public description
The public description is a Released system field that can not be changed.
Click on a card within a Released roadmap view to edit the public description inline. Add text, images or videos to the description. See the Editor documentation for details.
Editing issue details
Fields other than the public description can be edited on the full issue view.
To open the issue view:
Click on the issue key lozenge when hovering over a card, or
Click on Edit issue from the card detail view.
Publishing
To publish your roadmap, click the "Publish" button in the top right corner.
Once a roadmap has been published, a switch will appear on the page embed. Allowing you to navigate between the Changelog and the Roadmap.
Unpublishing
To unpublish the roadmap view, simply press the unpublish icon right next to the publish button. Your roadmap will be immediately unavailable on the page embed.
Last updated
