Get hands-on training for JIRA Software, Confluence, and more at Atlassian Summit Europe. Register now ›

The Tip of the Month, brought to you by Atlassian University, is a monthly series to help master Atlassian tools. Products are more fun to use when you know all the tricks.

Creating one source of truth for project collaboration and issue tracking is effortless with an improved way to display JIRA issues in Confluence. While it’s always been easy to bring your issues into Confluence, you now have more control over which issues show up and how they appear.

Bring JIRA into Confluence. It’s easy.

Remember, you can surface everything your development team is working on in JIRA to the teams that live in Confluence by inserting issues in pages using Autoconvert.

Copy. Paste. Done.

To review, the quickest ways to insert issues into page are to:

  1. Paste the URL of an issue into the Confluence editor; or
  2. Paste the URL of a JIRA filter into the Confluence editor

It’s that simple. Here, I’ll show you:











Automatic linking? You betcha.

Whenever you insert a JIRA issue in a Confluence page JIRA will create an issue link to that page for you, automatically. Agile product requirements to user stories, knowledge base articles to bugs – it all works.

One more thing…

If you’re anything like me you never like to switch contexts. Next time you’re writing a sprint report or publishing release notes you don’t even have to leave the Confluence editor to insert your completed tasks and resolved issues. Just use the Insert JIRA Issue dialog – find it in the Insert menu or use the keyboard shortcut, ‘command/control + shift + j’.


Pro tip: Paste JIRA filter URL’s directly into the search box. Confluence will covert the URL to JQL on-the-fly.

It just got better: A new and improved JIRA Issues Macro

Starting now, when you insert multiple issues into a page the new JIRA Issues Macro gives you more control over how they’re displayed. Oh, and they look a whole lot better too.

Display the details you care about

Now you have more control over how you display your issues to your team in Confluence.

  1. Choose to display the number of issues returned by your search as an issue count, e.g. 36 issues; or
  2. Provide more detail by displaying your issues in a table with columns for each issue field that you can choose to show or hide


With all your issues in Confluence, your team and your stakeholders have one source of truth for tracking everything related to your JIRA project.


Try it today

Using OnDemand?

You’ve been auto-updated – log in and start sharing your JIRA issues in Confluence.

Using Confluence Download?

Confluence 5 and above: Update to the latest version of the JIRA issues macro via the Universal Plugin Manager in the Confluence Admin console.

Earlier versions of Confluence: Upgrade to the latest version of Confluence.

New to Confluence?

Get up and running in a matter of minutes with a free Confluence OnDemand trial.


Learn more about using JIRA and Confluence together

Fresh ideas, announcements, and inspiration for your team, delivered weekly.

Subscribe now

Fresh ideas, announcements, and inspiration for your team, delivered weekly.

Subscribe now