Navitabs - Navigation Macros for Confluence Data Center
Breadcrumbs

Tabs and their content load slowly

\uD83E\uDD14 Problem

When accessing a page with Navitabs macros, the tabs and their content take a long time to load.

https://communardo.atlassian.net/wiki/s/559262338/6452/6115fb25c37f24a5c84be0cbd66bb60564dc30eb/_/images/icons/emoticons/information.png Cause

Confluence Data Center/Server allows the nesting of macros within other macros. For example, it is possible to nest one level of Navitabs tabs within other Navitabs macros. Other load-intense macros include:

  • Page properties report

  • Jira macros for issues, roadmaps, etc.

  • Charts of all kinds

  • Attachments

Navitabs macros work by immediately loading and rendering all the pages within their structure, including any nested macros in pages.

Example: If 10 tabs are gathered through the Labeltabs macro, all 10 tabs and their content are immediately rendered and ready for display, even if the user doesn’t click on the inactive tabs. The Navitabs macro will only finish loading once the entire content has been rendered.

⏲️ This results in a high loading time every single time a user accesses the page.

\uD83C\uDF31 Solution

Use nested macros mindfully: Only use complex nesting if this is absolutely necessary for your use case. This is also highly relevant if you are considering migrating to Confluence Cloud in the future.


Try to reduce the macro complexity on pages that are accessed frequently and are therefore often impacted by slow page load. Possible workarounds:

  • Use Navitabs' Childtabs and Labeltabs for pages with relatively simple content.
    Use built-in macros like “Children Display” or “Content by Label” or insert direct links if the child or referenced pages contain complex macros.

  • Use Labeltabs with very specific labels to avoid the loading of irrelevant content.

  • If you have to use a generic label for Labeltabs, limit the number of tabs displayed in the macro settings by

    • limiting the label to the current space.

    • reducing “Max Number of Tabs” (default is 20 pages).

    • using two generic labels and combining them with AND.