Display Jira macros content in tabs
In the Server version of tabs, it is possible to embed any content within a tab, such as Jira Issues Macro and Include Page Macro, in order to create a single, high-level overview page of all information needed.
Confluence Cloud currently does not allow nested macros. But this functionality can be replicated by using the Pages to Tabs macro.
In this example, we will create an overview page for a Support Manager who needs to quickly view their team’s Jira tickets for planning and auditing purposes.
This page will use the Pages to Tabs macro combined with the standard Jira Issues macro (Atlassian) to display a series of tabs that show team members' Jira issues.
The tabs will display pages containing the Jira Issues macro, which dynamically pulls data from Jira, allowing real-time updates reflected in the tabs.
Ingredients
Apps | Composition Jira |
---|---|
Macros | Pages to Tabs |
Guide
Prerequisites
We recommend you have a basic understanding of how to use Jira and Confluence together, and also the Jira Issues Macro.
More details are available on these Atlassian pages:
Create a parent page to serve as an overview page. For now, you can just provide a suitable title and some text and Publish it.
Create child pages for each user under the parent page. Provide suitable titles; they will be used later as tab titles. For this example, team members' names are the page titles.
In each child page, insert a standard Jira Issues macro (Atlassian), and use Jira Query Language (JQL) to filter the issues assigned to a user. Click on the search button to see a preview of issues.
You can also click on Display options to adjust settings such as Maximum issues and Columns to display. Click Insert to continue.Publish the page. Repeat step 3 for each team member's child page.
When you have finished creating all the child pages, return to the parent page you created earlier. Insert a Pages to Tabs macro via the macro browser, or use the keyboard shortcut ( "/" for new editor or "{" for old editor).
The Insert Pages to Tabs Macro popup will appear. In the Source section, select Page selector from the dropdown. In the Parent page section below, the current page has already been selected (default).
Click Save to continue. The macro will appear on the editor, with the children page titles. You can edit the tab names with a custom name and choose the tab's position.
Click Save again to see the final results.
You should see a series of tabs showing team members' Jira issues along with issue details. The Jira issues macro dynamically pulls data from Jira, ensuring updates will always be reflected in the tabs.
Notes
IMPORTANT
Each macro can render a maximum of 25 children pages as tabs.
Only the first level of children pages are rendered. That is, children of children pages will not be rendered.
Result
Not applicable.