Nesting macros in Navitabs: What to keep in mind

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

 


In a nutshell

Due to how macros work in Confluence Cloud, there are limitations when nesting other 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 is not supporting gadgets inside nested macros.

Background information

Currently, nested rich body macros are not supported in Confluence Cloud (see this ticket).

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 on the published page (even if the preview worked fine)

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

 

Possible workarounds

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

  • If you are using the new Confluence Cloud editor, please use the Tabs macro with its built-in editor. However, as stated before, nested rich body macros are not currently enabled in Confluence Cloud, so various macro combinations might 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).

The list does not cover the Navitabs Tabs macro with its own editor.

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/DC 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

More detail

Macro

New Editor

Legacy Editor

More detail

Tab / Tab Group (Navitabs)

No

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

New editor: This is not possible.

Language X (Translations)

No

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

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



Chart

No

No

Legacy editor: Nothing is rendered.

New editor: macro cannot be nested.

Cheese

macro not available



Children Display



Code Block

macro not available

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 label

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

Content by user

macro not available



Content report table

 

Contributors

 

Contributors Summary



Create from Template

No

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

Create Space Button

macro not available

 

Decision

macro not available

 

Emoticons / Emojis

No

use workaround

No

Legacy editor: Emoticons and symbols don’t display. Emojis are not available.

New editor: Emojis can be inserted in the editor, but they do not display (or are displayed as a blue star) once the page is published. This is a known bug reported to Atlassian.
As a workaround, use unicode emojis that you can insert using Win & + (Windows) or control & command & space (Mac).

Excerpt

No

New editor: Excerpt can’t be inserted.

Excerpt include

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

Expand

No

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

 

Gallery

New editor: Works, but images are not clickable.

Global Reports

macro not available

No

Icons are not found. Links are provided.

Include Page



Info

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

iFrame

 

Provided that the source URL allows a connection.

Jira

No

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

New editor: Works partially.

Jira Chart

 

Jira Issue

No

No

 

Jira Gadgets (Reports)

No

No

Nothing is rendered

Jira Roadmap

No

No

 

Labels List



Live Search

No

 

Lorem Ipsum

macro not available



Multimedia

macro not available

No

Nothing is rendered

Navigation Map

macro not available



No format

macro not available

 

Note

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

Opsgenie Incident Timeline

macro not available

 

Page Index



Page Properties

No

New editor: cannot be inserted

Page Properties Report

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

 

Page Tree Search

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



Popular Labels



Profile Picture



Recently Updated & Rec. Updated Dashboard



Related Labels



Roadmap Planner



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

It 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



Team Calendar

 

Tip

It 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

macro not available

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

User List

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

User Profile

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.

Warning

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

Widget Connector

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 via support@bitvoodoo.ch.

 

Resources