Tab Wizard
Screenshot of the Tab Wizard options
Using this macro
New Confluence editor
Edit your page, type “/Tab Wizard” and choose the macro “Tab Wizard”.
Select one of the four options to create your new tab navigation in the overlay. The options are explained in detail below.
After you’ve selected it, the overlay will adapt to show you all the options.
If you feel you have made the wrong selection, you can always return to the Tab Wizard by using the “Go back” button at the bottom of the overlay.
If you don’t want to add tabs, click “Cancel” to close the Tab Wizard.
The Tab Wizard is not the right choice if you want to create tabs containing Confluence macros like Child Display, Jira, Page Properties Reports, etc. Please use the Tab Group and Tab Macro instead.
Legacy Confluence editor
We strongly recommend using the Tab Wizard macro in the new Cloud editor. However, if you need to use it in the Legacy editor, proceed as follows:
Insert the Tab Wizard by using {Tab Wizard.
Click into the macro and select “Edit”. This will open the Tab Wizard overlay.
Choose the right macro setting (see the documentation below).
Fill in your tabs in the macro overlay and tap “Save”.
The content in the Tab Wizard macro will look something like this:
⚠️ Don’t edit tabs' content in this view. If you want to modify something, open the Tab Wizard interface again by tapping the macro and selecting “Edit”.
Save your page to see the tab navigation in action.
Tips for more space
You can expand the macro overlay to span the entire screen width.
You can also shrink the macro settings on the left side.
-20230124-111033.gif?inst-v=d6c2fd6c-2c2a-4682-827f-da09c49a8cfb)
Expand the editor window, shrink the macro settings
Tips for Navigation
With the “Show info cards on hover” setting enabled, users can view more detailed information about linked tabs. This is especially useful if the current Tab navigation is based on pages spread across various locations or spaces.
Note: This feature applies to macros that gather existing content and is unavailable for tabs with created content, like “Tab Groups” or the “Tab Wizard: Create Your Own Tabs” option.
When hovering over the tabs, a card will show breadcrumb navigation to indicate the page origin, the last update date, and quick-access options to view or edit the content directly.
This feature can be toggled off in the settings. See below for how to adjust this in each macro.
Screenshot of the Tab Cards in action
Select existing content
How it works: Search for and select existing Confluence content. Then, tabs displaying their content will automatically be generated.
How to use this macro
Insert the Tab Wizard macro on a page.
Tap “Select existing content” in the Tab Wizard.
In the field “Content,” type in the name of a specific page, whiteboard, database or smartlink*.
Repeat for any other content you want to display as a tab.
Drag & drop page names to choose the order of the tabs.
Adapt the general settings (see options below).
Use the preview to check if everything looks as expected.
Tap “Save” and publish the page.
Result: The content of the selected pages is displayed as tabs on the page.
General settings of this macro
Content:
Search and select existing content (page, blog post, whiteboard, database or SmartLink*).
Tab Layout Toggle
“Use new layout” (Beta) to allow advanced features - see Tab Content Layout (Beta)
Tab Design
Choose a specific tab design - see Tab Design Customization for details.
Tab Configuration
Display the tabs vertically: Toggle to display the tabs in this order, by default, tabs are oriented horizontally. Using vertical tabs, you can customize the tab width (the default is 150 pixels).
NEW Show info cards on hover: On hover, display a card with the page title, origin, last updated date, and shortcuts to view or edit the page.
To truncate tab names, enter the number of characters that will be removed (starting from the beginning of the tab names). This makes sense in long page titles to save space. By default, the entire title appears.
Tab Content Height
To change the tabs' height, set a new value (in pixels) in the "Tab Content Height" field. The default height is 750 pixels. You may have to change the height manually for long content.
Settings of the macro option “select existing content“
Define a parent content
This used to be done with the Childtabs macro. It is now integrated into the Tab Wizard.
How it works: Define the parent page. This will automatically generate tabs displaying the children's content.
How to use this macro
Insert the Tab Wizard macro on a page.
Select “Define a parent content” in the Tab Wizard.
In the field “Root,” enter the specific parent content.
Content that can be selected are pages, whiteboards, databases, and smartlinks*.
Leave the field blank to use the current page.
Adapt the general settings (see options below).
Use the preview to check if everything looks as expected.Tap “Save” and publish the page.
Result: The children of the selected parent with all their content are displayed as tabs on the page.
General settings of this macro
Root Page
Select the page from which the navigation will be created. The default value is the Current Page.
Tab Content Layout
The new Tab Content Layout (Beta) allows for a different method to render the content (see differences).
Tab Design
Select and use a specific Tab Design, or create and customize your own.
Tab Configuration
Display tabs vertically: By default, tabs are oriented horizontally. This toggle allows them to display vertically instead
Width of vertical tabs: Allows you to customize the width of titles when using Vertical tabs (the default is 150 pixels).
NEW Show info cards on hover: On hover, display a card with the page title, origin, last updated date, and shortcuts to view or edit the page.
NEW Max number of tabs: Select the number of tabs to be rendered from 1 to 50. The default value is 20.
NEW Sort tabs by: You can sort the resulting tab navigation between:
Alphabet (A-Z) default
Creation date (new to old)
Modification date (new to old)
Page Tree (This is the default order. When selected, this value will replicate the page tree from the page designated as root).
Reverse the tab sort order: This will invert the currently assigned sorting.
Number of characters to truncate: To truncate tab names, enter the number of characters to be removed (starting from the beginning of the tab names). This makes sense in long page titles to save space. By default, the entire title appears.
Tab content height
To change the tabs' height, set a new value (in pixels) in the "Tab Content Height" field. The default height is 750 pixels. You may have to change the height manually for long content.
Settings of the macro option “Define a parent content“
Define labels
This used to be done with the Labeltabs macro.
How it works: Define one or various labels. This will automatically generate tabs of pages containing the label(s) and display their content.
Option: Define labels
How to use this macro
Insert the Tab Wizard macro on a page.
Select “Define labels” in the Tab Wizard.
In the field “Labels”, insert the label(s) that the pages should contain.
Optional: Use a CQL query to narrow down the results. For example, you can filter for the space “Spacename” using this query:
CODEspace = "Spacename"Optional: Adapt the general settings (see options below).
Use the preview to check if everything looks as expected.Tap “Save” and publish the page.
Result: The pages containing the label(s) with all their content are displayed as tabs on the page.
Tabs with page content with a specific label
General settings of this macro
Labels
You can input one or multiple labels separated by a comma. All pages matching these labels will be displayed as a tab.
Filter
You can customize the condition to create these tabs based on a CQL Query.
Tab Layout
Use New Layout: This toggle renders the page using the Tab Content Layout (Beta), affecting content rendering.
Tab Design
Select and use a specific Tab Design, or create and customize your own.
Tab Configuration
To display the tabs vertically, activate the toggle "Display the tabs vertically.” By default, tabs are oriented horizontally.
Using vertical tabs, you can customize the tab width (the default is 150 pixels).
NEW Show info cards on hover: On hover, display a card with the page title, origin, last updated date, and shortcuts to view or edit the page.
NEW Max number of tabs: Select the number of tabs to be rendered from 1 to 50. The default value is 20.
NEW Sort tabs by: You can sort the resulting tab navigation between:
Alphabet (A-Z) default
Creation date (new to old)
Modification date (new to old)
To reverse the tab order, activate the toggle “Reverse the tab sort order.”
To truncate tab names, enter the number of characters that will be removed (starting from the beginning of the tab names). This makes sense in long page titles to save space. By default, the entire title appears.
Tab Content Height
To change the tabs' height, set a new value (in pixels) in the "Tab Content Height" field. The default height is 750 pixels. You may have to change the height manually for long content.
Settings of the macro option “Define labels“
Create your own tabs
This used to be done with the Tabs Editor but has been extended with the Tab Wizard.
How it works: Create tab content individually or mix individual tab content with existing Confluence pages. Options include:
Your content: Use the editor to create content from scratch
Embed or HTML Code
iFrame
Existing Confluence content (pages, whiteboards, databases, smartlinks*).
Option: Create your own tabs
How to use this macro
Insert the Tab Wizard macro on a page.
Select “Create your own tabs” in the Tab Wizard.
In “Tabs & Tab Names,” first write a name for your tab. Hit “Enter” or tap the + icon to add the tab.
Repeat for any number of custom tabs.
Drag & drop tab names to choose the order of the tabs.
On the right side of the macro, select the type of content you want to add in the drop-down (details see below).
Adapt the general settings (see options below).
Tap “Save” and publish the page.
General settings of this macro
The following settings are identical for the macro options “Your content,” “Embed,” “iFrame,” and “Confluence content.”
Tabs & Tabs Names
Create your tab by adding a name and clicking the plus icon. Tabs can be drag-and-dropped and further customized with a tab icon.
Tab Content Layout
Use New Layout: This toggle renders the page using the Tab Content Layout (Beta), affecting content rendering.
Tab Design
Select and use a specific Tab Design, or create and customize your own.
Tab Configuration
To display the tabs vertically, activate the toggle "Display the tabs vertically." By default, tabs are oriented horizontally.
Using vertical tabs, you can customize the tab width (the default is 150 pixels).
NEW Show info cards on hover: On hover, display a card with the page title, origin, last updated date, and shortcuts to view or edit the page.
Tab Content Height
You can change the tab’s height by inputting a new value (in pixels). The default height is 750 pixels.
You may have to change the height manually for long content.
For “Your content,” there is no need to adapt the tab height. The tab height will be adapted automatically according to the amount of content inserted.
Settings of the macro option “Create your own tabs“
Macro option: Your content
You can enter your own tab content (text, images, status, panels, etc.) the way you are used to in the Confluence Cloud editor. This content will be displayed within the tab you created and labeled before.
How to use this option
Choose “Your content” in the drop-down menu.
Enter your text and other content (options see below) in the editor input field.
Tip: You can expand the editor to span the entire screen width. You can also shrink the macro settings on the left side.Tap “Save” once you are done.
“Your content” with built-in editor
Options in the built-in editor:
This editor is useful for simple content.
If you want to create tabs containing Confluence macros like Child Display, Jira, Page Properties Reports etc., please use the Tab Group and Tab Macro instead.
See Nesting macros in Navitabs for all details.
If you want to embed content or use an iFrame, use the options below instead of “your content.”
Embed or HTML Code
You can use an embed or HTML code as a tab.
Choose “Embed or HTML Code” in the drop-down menu.
Paste the code in the field below.
Use the “Preview” toggle to check whether the content looks as intended.
Tap “Save” once you are done.
iFrame
You can include an iFrame as a tab. This allows you to embed external content on your Confluence page.
An iFrame is an HTML element that embeds another HTML document within a page. The iFrame has its own scrollbars, borders, and content. Note: Not all websites allow their content to be embedded in an iFrame. If the content you want to embed is protected or restricted, the iFrame may not work.
Choose “iFrame” in the drop-down menu.
Paste the target URL.
By tapping the dots :more-dots: , you can specify the width and height of the iFrame in pixels or as a percentage of the parent container.Tap “Save” once you are done.
iFrame with preview in Tab Wizard editor
Confluence Content
Use this option to mix existing Confluence content with individual page content in one macro. If you need a tab navigation of only Confluence pages, use one of the other options in the Tab Wizard ⤴️.
You can select existing Confluence content.
Choose “Confluence content” in the drop-down menu and search for the name of your content.
Content can be a Confluence page, whiteboard, database or smartlink*.
The preview of the Confluence page will appear in the editor.
⚠️ You cannot edit its content here.
Use other options in the drop-down for the different tabs in your navigation.
Tap “Save” once you are done.
Screenshot: Selecting Confluence content option
Notes
Smartlinks*: Currently, Smartlinks aren’t fully supported due to Cloud limitations.
Adding them as tab content will show only a URL.
To avoid this, consider placing the content (when possible) on a Confluence page and using that page as the tab’s source.
Screenshot: Smartlinks as tab content