Skip to main content
Skip table of contents

Nesting macros in Navitabs: Restrictions in Confluence Cloud

The following information applies to the cloud apps Navitabs - Tabs for Confluence and Translations for Confluence.


In a nutshell

⚠️ Confluence Cloud has limitations when nesting built-in and 3rd-party macros in some bitvoodoo macros. Affected macros:

  • The nesting of macros is possible if they don't have a rich body (prevented by Atlassian; see below)

  • Gadget macros are not working (e.g., Jira gadget), as Atlassian does not support gadgets inside nested macros.

Background information

Currently, nested rich body macros are not supported in Confluence Cloud. This is a frequently voted-for Atlassian issue; see this ticket. We are watching that issue and will adapt as soon as Atlassian changes anything.

Rich body vs. block macros

  • Rich body macro: a container in which the page editor can type text or insert page elements.
    Examples: Tab&Tab Group, Info, Panel, language macros

  • Block macro: a static element that pulls content into the page based on properties set in the macro. The page editor cannot type inside the macro.
    Examples: Table of Contents, Children Display, Labels List


What you’ll experience when trying to nest bodied macros is one of the following:

  • Error message in the preview or on the published page

  • Strangely formatted content on the published page (see formatting issues in nested macros)

  • No content at all or incomplete content on the published page (even if the preview worked fine)

  • New Cloud editor: If you try to insert a macro inside another, it will be placed below the first macro.

Possible workarounds

  • Use nested macros mindfully: Only use complex nesting if this is absolutely necessary for your use case. Try to reduce the macro complexity whenever possible.

  • If you are facing difficulties nesting macros, you should use them separately on your pages or spread them over various pages.

  • If you are using the new Confluence Cloud editor, please use the option Tab Wizard - Create your own tabs with its built-in editor.
    Switch to Tab Content Layout (Beta) and try to use your macros there. However, as stated before, nested rich body macros are not currently enabled in Confluence Cloud, so various macro combinations will not work in the macro editor either.


List of Atlassian and 3rd-party macros & whether they work within Navitabs/Translations macros

To help you clarify which macro combinations are possible and which are not, we have created a list of Atlassian macros and popular 3rd-party macros (listed alphabetically).

New Confluence Cloud vs. old (legacy) editor

  • In the following table, we distinguish between macros used in the old (Legacy) and the new Confluence Cloud editor.

  • When migrating pages from Server or Data Center to Cloud, all content is transferred to the Legacy Cloud editor. The Legacy editor allows for certain nested rich body macros while the new one does not. However, the Legacy editor might not be supported forever.

  • Please consult the documentation on the differences before deciding which editor to use in the future.

Macro

New Editor

Legacy Editor

Beta Layout

More detail

Tab / Tab Group (Navitabs)

NO

(tick)

Legacy editor: “Tab” and “Tab Group” can be nested within language macros.

New editor: This is not possible.

Language X (Translations)

NO

(tick)

Legacy editor: Language macros can be nested within tab macros.

New editor: This is not possible.

Anchor

NO

NO

Because of limitations in how Cloud macros are rendered, this is not possible in Cloud.

Attachments

works partly

works partly

The thumbnail is generated, but clicking on the macro will lead to the file directly (usually download via web browser) instead of opening the preview.

New editor: The macro goes beyond the tab macros while editing. The published page looks ok.

Blogposts

(tick)

(tick)

New editor: Blog posts work but don’t look nice: The avatar image is not displayed, and the image name disturbs the layout. The blog content itself is displayed as expected.

Change History

(tick)

(tick)


Chart

NO

NO

Legacy editor: Nothing is rendered.

New editor: macro cannot be nested.

Cheese

macro not available

(tick)


Child pages (formerly Children Display)

(tick)

(tick)


Code Block

macro not available

(tick)

New editor: This macro was removed from the new editor and replaced with the Code Snippet element.

Column

macro not available

NO

Works rudimentarily, but using Sections and Columns inside other macros is not recommended.

The single-column layout option was removed in the new editor.

Content by user

macro not available

(tick)


Content report table

(tick)

(tick)

Contributors

(tick)

(tick)

Contributors Summary

(tick)

(tick)


Create from Template

NO

NO

New editor: Macro can be inserted but does not work.

Create Space Button

macro not available

(tick)

Decision

(tick)

macro not available

draw.io diagram

(tick) (Navitabs)

NO (Translations)

(tick) (Navitabs)

NO (Translations)

Tabs: Both editors can display draw.io diagrams.

Translations: Both editors: Nothing is displayed when the diagram macro is placed within a language macro.
Please place the diagram macro outside a language macro.

Emoticons / Emojis

(tick)

NO

use workaround

Legacy editor: Emoticons and symbols don’t display. Emojis are not available.
As a workaround, use Unicode emojis that you can insert using Win & + (Windows) or control & command & space (Mac).

New editor: Both Unicode and Confluence emojis can be used. See our suggestions: Can I use emojis in tabs? ❤️

Excerpt

NO

(tick)

New editor: Excerpt can’t be inserted.

Expand

NO

(tick)

New editor: Can’t be inserted. It is not a macro in the new editor and is inserted via “/” command.

Favourite Pages

macro not available

(tick)

Filter by label (formerly Content by label)

(tick)

(tick)

New editor: Works, but the contents might be clipped.

Gallery

(tick)

(tick)

New editor: Works, but images are not clickable.

Global Reports

macro not available

NO

Icons are not found. Links are provided.

Include Page

(tick)

(tick)


Info

(tick)

(tick)

This is not a macro in the new editor and is inserted via “/” command.

Insert Excerpt (formerly Excerpt include)

(tick)

(tick)

New editor: Works, but the content in the excerpt might be clipped.

iFrame

(tick)

(tick)

Provided that the source URL allows a connection.

Inline comment

NO

NO

This is not a macro, but a known limitation: Inline comments cannot be added, and existing inline comments cannot be displayed in tabs and translations.

Jira

(tick)

NO

Legacy editor: List view works in some instances, single issues do not display.

New editor: Works partially.

Jira Chart

(tick)

(tick)

Jira Issue

NO

NO

Jira Gadgets (Reports)

NO

NO

Nothing is rendered

Jira Roadmap

NO

NO

Labels List

(tick)

(tick)


Live Search

(tick)

(tick)

Lorem Ipsum

macro not available

(tick)


Multimedia

macro not available

NO

Nothing is rendered

Navigation Map

macro not available

(tick)


No format

macro not available

(tick)

Note

(tick)

(tick)

This is not a macro in the new editor and is inserted via “/” command.

Opsgenie Incident Timeline

NO

macro not available

Page Index

(tick)

(tick)


Page Properties

NO

(tick)

New editor: cannot be inserted

Page Properties Report

(tick)

(tick)

The Page Properties Report macro is not displayed if it contains inline links (“Display inline” is the default setting). However, the macro works if the link output is changed to “Display URL”.
This is a bug that we have reported to Atlassian.

Page Tree

NO

NO

Page Tree Search

(tick)

(tick)

Legacy editor: The search field is rendered, but the search is rendered very narrowly.

New editor: Works, but the search is formatted strangely.

Panel

macro not available

(tick)


Popular Labels

(tick)

(tick)


Profile Picture

(tick)

(tick)


Recent Updates & Rec. Updated Dashboard

(tick)

(tick)


Related Labels

(tick)

(tick)


Roadmap Planner

(tick)

(tick)


Search Results

macro not available

NO


Section

macro not available

NO

Works rudimentarily, but using Sections and Columns inside tabs is not recommended.

Space Details

macro not available

NO

Legacy editor: Works, but doesn't display the space logo.

Spaces List

NO

NO

Legacy editor: Works but can't display icons.

New editor: Endless throbber, switching tabs isn’t possible in the Tab group macro.

Status

(tick)

(tick)

This is not a macro in the new editor and is inserted via “/” command.

Table of Contents

NO

NO

Both editors: Nothing is displayed when the macro is placed within a macro.
If the macro is placed outside a language macro, the TOC of all available languages will be displayed, but the entries cannot be clicked.

Task report

(tick)

(tick)


Team Calendar

(error)

(error)

Both editors: It is no longer possible to place Team Calendars within Navitabs macros. We recommend avoiding this combination.

Tip

(tick)

(tick)

This is not a macro in the new editor and is inserted via “/” command.

Trello Board

NO

macro not available

Legacy editor: Trello boards can only be inserted as links.

Trello Card

(tick)

macro not available

Legacy editor: Trello cards can only be inserted as links.

User List

(tick)

(tick)

New editor: Works, but the contents might be clipped.

User Profile

(tick)

(tick)

New editor: Works, but the user icon is displayed strangely.

View macros:
view-file, viewdoc, viewpdf, viewppt, viewxls

NO

NO

Both editors:

  • Thumbnail will not be generated

  • Nothing is rendered at all

If you insert the attachments into the macro via drag & drop: The thumbnail is generated, but clicking on the macro will lead to the file directly (usually download via web browser) instead of opening the preview.

Workaround: Insert the file in tabs with the Tab Content Layout (Beta) activated.

Warning

(tick)

(tick)

New editor: It is not a macro and is inserted via “/” command.

Widget Connector

(tick)

works partly

Legacy editor: Twitter and YouTube are displayed ok, others are not.

If you believe this list is incorrect or incomplete, please contact us.

Resources

JavaScript errors detected

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

If this problem persists, please contact our support.