How to Upgrade Composition from Confluence 3.x to 4.x and Above?
Take It Step By Step
After you upgrade Confluence, pages that contain Composition macros may render incorrectly.
If you are upgrading Confluence to v4.3 and above, there might be some problems with the wiki markup migration if you upgrade directly from Confluence v3.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:
A Note on Confluence 5.x
Confluence 5.0.x should not be required.
If you are at Confluence 4.3, you may upgrade to the latest version of Confluence 5.x.
Upgrade Instructions for Each Add-on
Unmigrated Wiki Markup
You may see that after the Composition add-on is enabled, the wiki markup does not convert or render correctly. If this happens, it is advisable to do the following: