How to link a Confluence roadmap to Jira work items

By Jake Marsh · Updated

To link a Confluence roadmap to Jira, put the roadmap in a Milewell macro, select a bar or milestone, click Link, choose Jira work item and search for the key or a word from its summary. The bar then shows a dot in the work item's status category color, and the panel shows its status, summary, start date and due date, with Use these dates to copy them onto the bar.

Before you start

  • Confluence's built-in Roadmap Planner links bars to Confluence pages only, so a Jira link needs an app.
  • Milewell must be connected to Jira on the same Atlassian site. A site admin can do this under Administration > Apps.
  • Milewell only reads from Jira. It never changes a work item's status, dates or fields.

Steps

  1. Add a Milewell roadmap to the page: edit it, type /Milewell, pick Milewell roadmap and publish.
  2. Add the bars for your epics or deliverables with + Bar, or import them from a CSV (see below).
  3. Select a bar and click Link in the panel on the right.
  4. Choose Jira work item and type a key such as PAY-142 or words from the summary. Pick the work item from the list.
  5. Click Use these dates if you want the bar to take the work item's start date and due date. Leave it if the roadmap should keep its own dates.
  6. Repeat for each bar. Milestones can be linked the same way.

What the status dot means

DotJira status category
GrayTo do
BlueIn progress
GreenDone

The status is read from Jira when the roadmap loads, so a work item moved to Done shows green without anyone editing the roadmap.

Linking many bars at once

If your bars come from a spreadsheet, add a Link column holding the Jira key of each row (for example PAY-142) and import it with Import > CSV file. Each row's key becomes that bar's Jira link. The same column can hold page: and a page id to link a Confluence page instead.

Who sees what

Readers see the details of a linked work item only if they can browse it in Jira themselves. Someone without access to the project still sees the bar, its title and dates on the roadmap, without the Jira status or summary.

What it costs

Milewell is $15 a month for up to 10 users, or $150 a year. From 11 users it is $1.50 per user a month, with lower rates for larger sites. Atlassian bills it, with a 30-day free trial. Install it and see every feature on the Milewell page, or read the Milewell documentation.

Milewell: Roadmaps and Gantt for Confluence

Roadmaps and Gantt charts on Confluence pages that save every change as a version, with dependencies, milestones and Jira links. From $15 a month for up to 10 users.


Questions

Will the roadmap dates update when the Jira due date changes?

No. Use these dates copies the dates once, so the roadmap stays the plan you agreed. The panel always shows the work item's current dates next to the bar's, and you can copy them again at any time.

Can I link a bar to a Jira project or a filter instead of one work item?

No. Each bar or milestone links to one Jira work item or one Confluence page.

What if the search can't find the work item?

Milewell only lists work items you can see. If you type a full key it can't find, you can still press Link to use that key.

Does linking need Jira Software?

It needs Jira on the same site with Milewell connected to it. Any work item type with a key can be linked.


More Milewell guides


More Confluence guides