/
How to upgrade apps from Confluence 3.x to 4.x and above

How to upgrade apps from Confluence 3.x to 4.x and above

Take it step by step

After you upgrade Confluence, pages that contain related apps, specifically Composition, Scaffolding, and Reporting macros may render incorrectly.

If you are upgrading Confluence to version 4.3 or later, there may be some problems with the Wiki Markup migration if you upgrade directly from Confluence version 3.x to the latest version.

It is recommended instead to upgrade Confluence version by version so that your data can be maintained.

Refer to the Confluence safety upgrade steps below to ensure all Wiki Markup data are migrated completely.

Upgrade instructions for each app

Before upgrading Confluence:

  • Go to Confluence Administration > Apps.

  • Disable the related app(s).

  • Upgrade Confluence.

You can upgrade the apps via the following methods:

  1. Download the .obr files for each app from the Atlassian Marketplace.

  2. Upload it via:

    1. Confluence Administration > Apps > Upload app.

    2. Confluence Administration > Apps > Upgrade.

  3. Enable the app(s).

Safety Upgrade Paths for Confluence with Composition, Scaffolding, and Reporting

Upgrade Confluence v3.x to Confluence v3.5.x with Composition 2.3.5, Scaffolding 3.4.2, Reporting 3.4.2

Upgrade Confluence v3.5.x to Confluence 4.2.x with Composition 3.0.3, Scaffolding 4.0.4, Reporting 4.1.0

Upgrade Confluence v4.2.x → Confluence 4.3.x with Composition 3.0.3, Scaffolding 4.6.5, Reporting 4.1.0

Upgrade Confluence v4.3.x → Confluence v5.8.x with Composition 4.0.0, Scaffolding 6.3.0, Reporting 5.3.0

While on Confluence 5.8.x, upgrade according to the following upgrade path:

  1. Composition 4.0.0, Scaffolding 6.3.0, and Reporting 5.3.0 to Composition 4.0.0, Scaffolding 6.3.0, Reporting 5.8.1

  2. Composition 4.0.0, Scaffolding 6.3.0, Reporting 5.8.1 to Composition 5.0.0, Scaffolding 8.0.0, and Reporting 6.0.0

  3. Composition 5.0.0, Scaffolding 8.0.0, and Reporting 6.0.0 to Composition 5.9.1, Scaffolding 8.8.0, and Reporting 6.6.0

On Composition 5.0.0 and later, Scaffolding 8.8.0 and later, and Reporting 6.6.0 and later, uninstall all older dependencies that are not required by the modern versions of Composition, Scaffolding, and Reporting. Refer to App Dependencies page.

Upgrade Confluence v5.x and Confluence v6.x with the latest compatible version of Composition, Scaffolding, and Reporting.

What if I'm only updating Composition, Scaffolding, or Reporting?

You can check out the following Knowledge Base on each respective app:

The rest of the apps do not require a specific upgrade path, as they don't acquire a large portion of wiki markup content compared to Composition, Scaffolding, and Reporting.

Unmigrated wiki markup content

Confluence might not be able to migrate some wiki markup content due to various reasons.

The most commonly encountered issue is the complicated structure on a page, which causes some part or an entire Confluence page to not be migrated. When this happens, you can try the following solutions

  • Rebuild the Confluence Index through Administration > Content Indexing > Rebuild both.

  • When running a force migration on Confluence, you can check the specific steps in the Atlassian documentation.

  • Manually migrate the wiki markup content by using the inserting Wiki Markup function on Confluence - access it using CTRL + SHIFT + D or Insert Macro > Insert Markup.