General App Documentation
General App Documentation
Breadcrumbs

Cloud Migration Hub: Navitabs - Navigation Macros for Confluence

Cloud Migration – Navitabs - Navigation Macros for Confluence

Atlassian is ending support for Confluence Data Center by March 2029.
This page explains how Navitabs - Navigation Macros for Confluence will be migrated from Confluence Data Center to Confluence Cloud, what you need to prepare, and what you can expect.

🔎 Quick overview

Question

Answer for Navitabs - Navigation Macros for Confluence

Migration effort and automation level

Low to Medium
Partially automated – Atlassian’s Cloud Migration Assistant handles technical content migration; some manual content rework may be needed.

Main risks/limitations

  • Cloud editor handles macros differently; nested macros may break and require rework.

  • Cloud doesn’t support DC's built-in icon library; emojis must be used instead.

Differences between Navitabs DC and Cloud Macros

Key prerequisites

  • Avoid nesting unsupported macros in Confluence app usage.

  • Update Navitabs to the latest DC version before migrating, as best practice.

  • Install Navitabs on the target Cloud instance before migration.

  • Review and adjust macro usage before migrating, e.g., remove exotic macros.

Best practice

  • User impact during migration: Users can continue working but may encounter read-only or minor restrictions when updating content.

  • Typical duration: From minutes to hours, depending on pages with Navitabs macros and nested content.

  • Best practice: Migrate during off-peak hours and check key pages afterward.

Available Cloud types

Navitabs - Navigation Macros for Confluence is available on Commercial Cloud and also on Government Cloud (FedRAMP-ready).

info What Navitabs - Navigation Macros for Confluence does

Navitabs enables Confluence users to transform long, cluttered pages into clean, tabbed or carded sections. This improves readability, navigation speed, and brand consistency.


This section explains how your Navitabs - Navigation Macros for Confluence data and configuration move from Data Center to Cloud.

🔄 How to migrate

Please unfold the sections below to view the complete, detailed instructions for the upcoming migration.

By expanding these folders, you will gain access to all the necessary steps and guidelines for a smooth, successful migration.

Before you start

Use this checklist before planning the migration.

Supported versions

  • Minimum Navitabs - Navigation Macros for Confluence version on Data Center: 6.1.2

  • Supported Confluence Data Center versions: 10.0.1 - 10.2.6

  • Navitabs - Navigation Macros for Confluence on Cloud: Link to Marketplace

Preparation

How the migration works

📖 Migration approach

Using Atlassian migration tools (recommended)

  • Use the Confluence Cloud Migration Assistant (CCMA) to migrate pages that include Navitabs macros.

App-specific export/import
Not necessary: Navitabs macros and their content are stored in page content and are migrated with standard content migration.

Recommended option for most customers
We recommend using the Cloud Migration Assistant with Navitabs included in the migration run. This automates the transfer of Navitabs macros and content. Only content with nested unsupported macros or formatting may need review or manual restructuring before/after migration.

🔢 Step‑by‑step

Step 1 – Prepare on Data Center

  • Check Confluence and Navitabs versions; update if needed.

  • Create and verify a Confluence backup.

  • (Optional) Run a test migration in a staging environment.

  • Communicate the timing and impact of migration to users.

Step 2 – Run the migration
If using Atlassian migration tools:

  • Start the migration wizard.

  • Select spaces and include content with Navitabs macros.

  • Start the migration and monitor progress.

If manual export/import is needed (rare):

  • Migrate pages via standard content export/import.

  • Install Navitabs on Cloud and verify pages post-migration.

Step 3 – After the migration in Cloud

  • Check that Navitabs macros and content are present and correctly rendered.

  • Adjust Cloud-specific settings and formats (e.g., Tab Wizard settings, macro height).

  • Inform users that Navitabs in Cloud is ready to use.

After Migration

🎉 Congratulations, you have successfully migrated Navitabs from Data Center to Cloud.

Cloud-only benefits

  • Modern tab creation with Tab Wizard, including content from pages, whiteboards, smart links, and more.

  • Enhanced cloud macro settings and layout options.

  • Support for embed, iFrame, and external content via Tab Wizard (Cloud).

Reference / Blog:

🤝 Support & resources

❓ FAQ for Navitabs - Navigation Macros for Confluence migration

  • Can users work while the migration is running?
    Users can continue editing other content, but consider read-only mode for spaces that heavily use Navitabs to prevent content changes during migration.

  • What is not migrated automatically?
    Formatting of nested macros, taller heights, or icon library customizations: These may not migrate perfectly and require review.

  • What are the biggest changes compared to Data Center?

    • Macro naming and availability changes: Some macros are renamed or deprecated.

    • No built-in icon library in Cloud.

    • Cloud editor limitations on nested macros.

  • Are you a solution partner and have questions about licensing during migration?
    Contact us via Partner Fast Lane