Roadmaps
Communicate your plans with stakeholders and customers.
Last updated
Was this helpful?
Communicate your plans with stakeholders and customers.
Last updated
Was this helpful?
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 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
Aside from the initial creation via the empty state, there are 3 ways to create additional roadmaps in a workspace.
You can create a new roadmap using the roadmap selector found in the breadcrumbs navigation.
The more (⋯) menu offers a range of options for managing the current roadmap and also provides the ability to create a new roadmap.
When adjusting the filter or display options of a roadmap, you can either save the current roadmap or use the dropdown arrow to Save as new and create a separate version.
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.
Choose between Board and Timeline views based on your needs.
For most roadmap communication, the Board view is ideal — it shifts the focus from specific dates to broader goals, priorities, or any structure you define.
When you need to align on delivery dates, switch to the Timeline view to support that conversation.
Because Roadmaps in Released are highly flexible — allowing you to include work items from multiple projects — each view type requires a bit of setup. You’ll find setup instructions for each view below.
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.
The following field types are currently supported for column mapping.
• Status
• Select (Multi-select is not yet supported)
• Version
For each project, you can define which start and end date fields should be used to position items on the timeline. Released will make an initial best guess based on your project data, but you can update these fields at any time.
This gives you the flexibility to use different date fields across different projects — ideal if teams track timelines in different ways.
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.
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.
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.
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.
Short text
Status
Flagged
Labels
Date / Time-date
Select
Multi-select
Issue type
Checkboxes
Radio Buttons
Rating (Jira Product Discovery)
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.
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.
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.
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.
You can delete a roadmap through the More (⋯) menu in the top-right corner. Deleting a roadmap also unpublishes it, immediately removing it from the portal view.
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 within the space.
Support for additional field types, including date-based columns, is planned for future updates. Please if you would like us to support a specific field type.
