Hi Atlassian Community,
I’m David Michelson, a product manager on Confluence Cloud. We've been working on an exciting update to modernize the experience of inserting Jira issues into Confluence--making keeping your team in sync about work in Jira easier than ever. Introducing, Jira Issues (/Jira Issues)! We are gradually rolling out the feature, so you may not see it in your instance yet.
Using what we’ve learned from how customers use our previous solution, the Jira Issues Macro (formerly /Jira, now /Jira Legacy), we’ve made it easier than ever to insert and view Jira issues in Confluence using our new element, Jira Issues (/Jira Issues), thanks to the following improvements:
✍️ JQL suggestions, syntax highlighting, and error highlighting
🤌 Drag-and-drop field re-ordering & a simple dropdown to add or remove fields
🎨 Modernized and simplified visual design
♾️ Infinite scroll through Jira issues
🔎 Support for basic keyword search & simple Project, Type, Status, and Assignee Dropdowns
To get started with Jira Issues, when editing a Confluence page:
Select the +
menu in the toolbar, search for "Jira," and pick “Jira Issues”
Or, just type "/jira" directly in the editor and pick “Jira Issues”
Then, make a search for the issues you’d like to insert either with basic keyword and dropdown search or JQL (learn more about JQL). For example, you may want to grab all the issues assigned to your team that have not yet been resolved so you can report on your team's progress in Confluence.
If you are a member of multiple Jira sites, use the site selector at the top to pick the issues from the site you choose.
Basic keyword and dropdown search:
JQL:
Once you have the issues you’re looking for, you can add or remove the fields/columns you want to display by clicking the column selector in the top right of the issue table. Then, you can drag-and-drop to re-order them if you like by simply clicking and holding the top of a column and dragging to a desired location.
If you’d like to insert issues as a simple count view smart link, select “COUNT VIEW” in the top corner.
Hit “Insert issues” and you’re done!
If you need to make any updates to your search query, simply click on the table or count link you inserted while editing and hit the pencil icon found in the toolbar at the bottom.
Now that you've inserted Jira Issues, try hovering over an issue key or summary! Notice the helpful preview where you can quickly copy the issue link, open a preview, and even update the status, right from Confluence 🤩
For an even simpler insertion experience, you can also just paste the URL of any Jira issue search or filter into the page, and it will automatically display as a Jira Issues table.
Just like the other methods, you can add or remove fields you want to display, and drag-and-drop to re-order them if you like.
If you need to make any updates to your search query, or whether you want it to show up as a table or count view, simply click on the table while editing and hit the pencil icon.
If you’d like to show a basic blue link instead, just hit undo after pasting.
How can I give feedback about Jira Issues?
Leave a comment right on this post! We are planning improvements to Jira Issues (for example, adding simple dropdown filters to basic search for fields like Project, Status, Assignee, and Type) and would love to hear from you (Update on 12/14/2023: We've released these!)
Why am I not seeing Jira Issues in my instance yet?
Since we are gradually rolling out Jira Issues to customer instances, you may not see Jira Issues just yet, but you should in the near future.
Does Jira Issues work with Jira Data Center/Server issues?
Jira Issues will not support Jira Data Center/Server issues. Jira Data Center/Server customers will continue to be able to use the Jira Issues Macro, which supports Jira Data Center/Server issues, via /Jira Legacy.
Can I use Jira Issues to display Jira information within vendor macros or Confluence macros like the Page Properties Report?
Jira Issues will not initially support vendor macros and some Confluence macros like the Page Properties Report (it will appear as a link to those macros). In the meantime, customers can still use the Jira Issues Macro, which supports vendor macros and Confluence macros like the Page Properties Report, via /Jira Legacy
David Michelson
Product Manager, Confluence Cloud
11 accepted answers
56 comments