What You Need to Know
Confluence Cloud imposes limitations when nesting Atlassian and third-party macros within certain Navitabs macros.
Affected Navitabs macros
Unsupported macro types and nesting scenarios
-
Gadget macros are not supported when nested (e.g., in a Jira gadget), because Atlassian does not support gadgets within nested macros.
-
Nested rich body macros are not supported in Confluence Cloud.
Rich body macros
Rich body macros provide an editable body where you can add content such as text, images, and other macros.
Typical examples include Tabs/Tab Group, Info/Note/Warning panels, Panel, and Code Snippet.
What you may see when nesting bodied macros
-
An error in the preview or on the published page
-
Unexpected formatting on the published page (see formatting issues in nested macros)
-
Missing or incomplete content on the published page (even if the preview worked)
Possible workarounds
-
Use nesting deliberately: rely on complex nesting only when essential and reduce macro complexity where possible.
-
If nesting causes issues, place macros separately on the same page or distribute content across multiple pages.
List of Atlassian and 3rd-party macros & whether they work within Navitabs
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). The table below shows compatibility with the Forge rendering engine.
|
Macro |
Forge |
More details |
|---|---|---|
|
Anchor |
No |
|
|
Attachments |
PArtly |
|
|
Blogposts |
PArtly |
|
|
Cards |
⚠️ Not tested |
|
|
Carousel |
⚠️ Not tested |
|
|
Change History |
|
Clicking a version redirects the current page. |
|
Chart |
No |
|
|
Cheese |
No |
Atlassian has discontinued this macro, so we cannot guarantee it will still work when nested. |
|
Child pages |
|
|
|
Code Snippet |
|
|
|
Confluence default Tables |
|
Table header colors may not display correctly; use a normal cell as header. |
|
Column |
No |
While this functionality works rudimentarily, it will soon be deprecated. Therefore, using Sections and Columns inside other macros is not recommended. |
|
Content by user |
No |
Atlassian has discontinued this macro, so we cannot guarantee it will still work when nested. |
|
Content report table |
|
|
|
Contributors |
|
|
|
Contributors Summary |
PArtly |
|
|
Create from Template |
|
|
|
Create Space Button |
No |
Atlassian has discontinued this macro, so we cannot guarantee it will still work when nested. It will be rendered, but it is no longer selectable. |
|
Decision |
|
|
|
Draw.io diagrams, boards and embeds |
⚠️ Not tested |
|
|
Emoticons / Emojis |
|
Unicode and Confluence emojis work. |
|
Excerpt |
No |
|
|
Expand |
No |
|
|
Filter by label |
PArtly |
Visual issues present. |
|
Global Reports |
No |
Atlassian has discontinued this macro, so we cannot guarantee it will still work when nested. |
|
Include Page |
|
|
|
Info |
|
|
|
Insert Excerpt |
|
Content might be clipped or styled differently. |
|
IFrame |
|
Rendered if source URL allows connection. |
|
Inline comment |
No |
Known limitation: Inline comments cannot be added in tabs or translations. |
|
Jira Issues |
|
|
|
Jira Chart |
|
|
|
Jira Issues Calendar |
No |
|
|
Jira Legacy |
PArtly |
Migrated to Jira Work Items for links to Cloud. |
|
Jira Gadgets (Reports) |
No |
Atlassian has discontinued this macro, so we cannot guarantee it will still work when nested. |
|
Latex macros (LaTeX Math - Appfire) |
No |
Nesting Forge macros not supported by Confluence. See here. |
|
Labels List |
|
|
|
Live Search |
PArtly |
|
|
Lorem Ipsum |
No |
Atlassian has discontinued this macro, so we cannot guarantee it will still work when nested. |
|
Multimedia |
No |
Atlassian has discontinued this macro, so we cannot guarantee it will still work when nested. Nothing will be rendered. |
|
Navigation Map |
No |
Atlassian has discontinued this macro, so we cannot guarantee it will still work when nested. |
|
No format |
No |
Atlassian has discontinued this macro, so we cannot guarantee it will still work when nested. |
|
Note |
|
|
|
Page Properties |
No |
|
|
Page Properties Report |
PArtly |
|
|
Page Tree |
No |
Added as "Content Tree" – stuck in loading spinner. |
|
Page Tree Search |
PArtly |
|
|
Panel |
No |
Atlassian has discontinued this macro, so we cannot guarantee it will still work when nested. |
|
Popular Labels |
|
|
|
Profile Picture |
|
Clicking opens the user profile in a new page. |
|
Recent Updates & Dashboard |
PArtly |
|
|
Roadmap Planner |
|
|
|
Search Results |
|
Available as "Confluence List" macro. |
|
Section |
No |
Atlassian has discontinued this macro. While it works rudimentarily, using sections and columns inside tabs is not recommended, and we cannot guarantee it will still work. |
|
Space Details |
No |
Atlassian has discontinued this macro, so we cannot guarantee it will still work when nested. |
|
Spaces List |
|
|
|
Status |
|
|
|
Table of Contents |
No |
|
|
Tab / Tab Group (Navitabs) |
No |
|
|
Task report |
PArtly |
|
|
Team Calendars |
No |
|
|
Translations macro |
⚠️ Not tested |
|
|
Trello Board |
No |
Atlassian has discontinued this macro, so we cannot guarantee it will still work when nested. |
|
User List |
PArtly |
Contents may be clipped; some emails may not appear. |
|
User Profile |
PArtly |
Link to user shown, but image doesn't work. |
|
View macros (view-file, viewdoc, viewpdf, viewppt, viewxls) |
No |
|
|
Warning |
|
|
|
Widget Connector |
|
Works as expected. |
If you believe this list is incorrect or incomplete, please contact our customer support.
Resources
🛠️ Open Atlassian tickets (please vote)