Skip to main content
Skip table of contents

Tab Wizard

This is a new Cloud macro, available since November 2022. It bundles the functionalities of the existing Navitabs macros Childtabs, Labeltabs, and Tabs. It also introduces the new option to select existing pages & embed external content. The wizard helps you make the right choice and set all parameters - all within a single macro.

Tab Wizard, as part of the Navitabs Cloud app

Using this macro

New Confluence editor

  1. Edit your page, type “/Tab Wizard” and choose the macro “Tab Wizard”.

  2. In the overlay, select one of the four options to create your new tab navigation. The options are explained in detail below.

  3. After you’ve selected, the overlay will adapt to show you all options.

    1. If you feel you have made the wrong selection, you can always go back to the Tab Wizard by using the button “Go back” at the bottom of the overlay.

    2. If you don’t want to add tabs, click “Cancel” to close the Tab Wizard.

  4. If you want to create tabs containing Confluence macros like Child Display, Jira, Page Properties Reports etc., the Tab Wizard is not the right choice. Please use the Tab Group and Tab Macro instead.

Legacy Confluence editor

Click to read about the Tab Wizard in the Legacy 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:

  1. Insert the Tab Wizard by using {Tab Wizard.

  2. Click into the macro and select “Edit”. This will open the Tab Wizard overlay.

  3. Choose the right macro setting (see the documentation below).

  4. 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”.

  5. 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.

Expand the editor window, shrink the macro settings


Select existing pages

This is a new option for Navitabs Cloud. It was introduced with the Tab Wizard.

How it works: Search for and select existing Confluence pages. This will automatically generate tabs displaying these pages' content.

How to use

  1. Insert the Tab Wizard macro on a page.

  2. Tap “Select existing pages” in the Tab Wizard.

  3. In the field “Pages”, type in the name of a specific page.

  4. Repeat for any other page you want to display as a tab.

  5. Drag & drop page names to choose the order of the tabs.

  6. Adapt the general settings (see options below).
    Use the preview to check if everything looks as expected.

  7. 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

  • 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.

  • To display the tabs vertically, activate the toggle "Display the tabs vertically". By default, tabs are oriented horizontally. If you use vertical tabs, you can customize the tab width (the default is 150 pixels).

  • 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.

  • 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.

Define a parent page

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

  1. Insert the Tab Wizard macro on a page.

  2. Select “Define a parent page” in the Tab Wizard.

  3. In the field “Root”, enter a specific parent page. Leave the field blank to use the current page.

  4. Adapt the general settings (see options below).
    Use the preview to check if everything looks as expected.

  5. 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

  • Tab Layout: Toggle “Use new layout” (Beta) to allow advanced features - see Tab Content Layout (Beta) for details.

  • Tab Design: Choose a specific tab design - see Tab Design Customization for details.

  • To display the tabs vertically, activate the toggle "Display the tabs vertically". By default, tabs are oriented horizontally. If you use vertical tabs, you can customize the tab width (the default is 150 pixels).

  • To reverse the tab order, activate the toggle “Reverse the tab sort order”.
    The default sort order is the order of the pages in the page tree. You can use drag and drop in the page tree to rearrange pages.

  • 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.

  • 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.


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.

How to use

  1. Insert the Tab Wizard macro on a page.

  2. Select “Define labels” in the Tab Wizard.

  3. In the field “Labels”, insert the label(s) that the pages should contain.

  4. Optional: Use a CQL query to narrow down the results. For example, you can filter for the space “Spacename” using this query:

    CODE
    space = "Spacename"
  5. Optional: Adapt the general settings (see options below).
    Use the preview to check if everything looks as expected.

  6. 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

  • Tab Layout: Toggle “Use new layout” (Beta) to allow advanced features - see Tab Content Layout (Beta) for details.

  • Tab Design: Choose a specific tab design - see Tab Design Customization for details.

  • To display the tabs vertically, activate the toggle "Display the tabs vertically". By default, tabs are oriented horizontally. If you use vertical tabs, you can customize the tab width (the default is 150 pixels).

  • To reverse the tab order, activate the toggle “Reverse the tab sort order”.

  • 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.

  • 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.


Create your own tabs

This used to be done with the Tabs Editor but has been extended by more options with the introduction of 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 pages

All options are described in detail below ⤵️ .

Tab Wizard - Create your own tabs

Create your own tabs - Drop-down

How to use

  1. Insert the Tab Wizard macro on a page.

  2. Select “Create your own tabs” in the Tab Wizard.

  3. In “Tabs & Tab Names”, write a name for your tab. Hit “Enter” or tap the + icon to add the tab.

  4. Repeat for any number of custom tabs.

  5. Drag & drop tab names to choose the order of the tabs.

  6. On the right side of the macro, select the type of content you want to add in the drop-down (details see below).

  7. Adapt the general settings (see options below).

  8. Tap “Save” and publish the page.

General settings of this macro

(tick) The following settings are identical for the options “Your content”, “Embed”, “iFrame” and “Confluence page”.

  • Tab Layout: Toggle “Use new layout” (Beta) to allow advanced features - see Tab Content Layout (Beta) for details.

  • Tab icon: After creating a tab, you can choose a specific tab icon.

  • Tab Design: Choose a specific tab design - see Tab Design Customization for details.

  • To display the tabs vertically, activate the toggle "Display the tabs vertically". By default, tabs are oriented horizontally. If you use vertical tabs, you can customize the tab width (the default is 150 pixels).

  • 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.
    (info) For “Your content”, there is no need to adapt the tab height. The tab height will be adapted automatically on the published page according to the amount of content you insert in the tab editor.

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.

  1. Choose “Your content” in the drop-down menu.

  2. Enter your text and other content (options see below) in the editor input field.
    (tick) Tip: You can expand the editor so that it spans the entire screen width. You can also shrink the macro settings on the left side.

  3. Tap “Save” once you are done.

“Your content” with built-in editor

Options in the built-in editor:

Click to see the full list
  • Heading selection (Normal text, Heading 1, Heading 2, etc.)

  • Bold

  • Italic

  • … option with Underline, Strikethrough, Code, Subscript, Superscript, Clear formatting

  • Text orientation

  • Text Color

  • Bullet point

  • Numbered list

  • Link

  • Table

  • Code Snippet

  • Info Panel

  • Quote

  • Divider

  • Date

  • Status

  • Image Upload

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.

  1. Choose “Embed or HTML Code” in the drop-down menu.

  2. Paste the code in the field below.

  3. Use the “Preview” toggle to check whether the content looks as intended.

  4. 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.

(info) 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.

  1. Choose “iFrame” in the drop-down menu.

  2. 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.

  3. Tap “Save” once you are done.

iFrame with preview in Tab Wizard editor

Confluence Page

Use this option if you want to mix existing Confluence content with individual page content in one macro. If you need a tab navigation made up of only Confluence pages, use one of the other options in the Tab Wizard ⤴️.

You can select an existing Confluence page.

  1. Choose “Confluence page” in the drop-down menu and search for the page name.
    The preview of the Confluence page will appear in the editor. ⚠️ You cannot edit its content here.

  2. Use other options in the drop-down for the other tabs in your navigation.

  3. Tap “Save” once you are done.


Related content

⤴️ Back to the top

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.