How to migrate Navitabs from Server / Data Center to Cloud

 

Please refer to our main documentation for the Migration Assistant for general instructions on how to migrate bitvoodoo apps.

The following information is specific for the app Navitabs - Tabs for Confluence.


Assessing macro usage within Navitabs macros

The app Navitabs is completely cloud-ready. However, Confluence Cloud has limitations when it comes to nesting macros (rich body & 3rd party macros).

  • For details on nesting of all standard Confluence macros, please consult the page Limitations when nesting macros.

  • As of Jul 20, 2021, 3rd party macros don’t work within other macros at all. This is due to a change in Atlassian’s security policy and has nothing to do with the Navitabs app.

 

We strongly recommend that you address the following points before starting the migration:

  • Are you using any other macros (standard or 3rd party) within Navitabs macros?

  • Are you going to use the old (Legacy) editor or switch to the new Cloud editor in the future?

Based on this assessment, you might have to rework the content on your Server/DC instance. Try to use as few “exotic” macros as possible on your pages. Also, use the remaining macros separately on the page instead of nesting them within Navitabs macros.

 


Migrating Navitabs content

Completing the macro usage assessment and carrying out the changes necessary in your Confluence instance are the hard parts of the migration.

The process of migrating Navitabs Server/DC to Confluence Cloud is easy from a technical standpoint.

  1. Install Navitabs - Tabs for Confluence in your Cloud instance.

  2. Migrate your content with the Migration Assistant by Atlassian (automated path).

  3. Done! The different Navitabs macros and their content are now in the cloud.
    You may notice differences in the names and user experience of Navitabs macros. These are listed in the table below.


Differences between Navitabs Server/DC and Cloud Macros

Server/DC

Cloud

Notes

Server/DC

Cloud

Notes

Navitabs

Navitabs (not selectable)

The Navitabs macro is working in the background to allow for a smooth migration from DC/Server. You can also edit existing Navitabs macros.

However, you cannot add new Navitabs macros in Cloud. Please use Childtabs or Labeltabs instead.

Childtabs

Childtabs

Labeltab

Labeltabs

Same experience, except for one difference:

You will need to set the Labeltabs' height manually (the default is 750 pixels).

Localtab-Group

Tab Group

Different name, the same experience. Existing Localtab-Group macros will automatically be renamed "Tab Group".

Localtab

Tab (used within a Tab Group macro)

Different name, the same experience. Existing Localtab macros will automatically be renamed "Tab (used within a Tab Group macro)".

Tabs Macro

New editing experience available only in Cloud.

 

Migrating from Server/DC to the Legacy Cloud Editor

When migrating pages from Server/DC to Cloud, all content is transferred to the Legacy Cloud editor.

After the migration, all tabs are displayed and work properly in the frontend. No data is lost. There is one special case: the “Tab (Deprecated)” macro.


Tab (Deprecated): This appears on two occasions:

  • If you migrated old Localtab macros.

  • If you try to insert more tab macros on a migrated page that still uses the legacy editor.

The macro itself works fine and can also be edited, new content can be added, etc. However, the macro will not work in the new editor (read below).

Switching from Legacy to New Cloud Editor

If you want to change to the new cloud editor, you will have to replace all occurrences of the macro “Tab (Deprecated)” with the macro “Tab”. Otherwise, the data in the tabs will get lost during the transition.

As an alternative, you can get rid of the macros “Tab Group” and only work with the new Tabs macro with its own editor.


Related Content