se the steps on this page to plan for complete migration from Composition Server to Composition Cloud:

Prerequisites

Review Migrate Composition Tabs from Confluence Data Center to Cloud.
Understand the feature differences between Composition Tabs for Confluence Data Center and Confluence Cloud.

Guide

1. Upgrade the Composition Tabs app

Update the Composition Tabs app to the latest version or at least to version 5.14.1 using the UPM inside the Confluence administration console.

Select Administration () > Manage apps.
Search for Composition Tabs and make sure that the app is updated.

2. Find all the Composition Tabs macros

Choose one of the options below to assess data compatibility between Composition Tabs Data Center and Cloud.

Option 1: Use the Macro Usage page

The Macro Usage page can show you the number of Composition Tabs macros on your site and the pages that contain them.

Select Administration ( ) > General Configuration.
In the left sidebar, under Administration, click Macro Usage.

You can also access the macro usage information using the shortcut <base-url>/admin/pluginusage.action.

Locate the macros under Composition.
Record the number of Composition macros on your site.
Identify how many macros need action and how many macros cannot be migrated.
- For the Deck of Cards and Card macros, you must run our pre-migration tool. See Step 3 later on this page.
- For the macros that cannot be migrated, alert users to take the next actions if needed. (The SQL method in Option 2 below may be more helpful in this regard, as it can also provide hints about the authors of this content.)
Click each macro link to view the pages containing the corresponding macro.

Option 2: Use a SQL query

Use the sample SQL query below to get all pages that contain non-migratable Composition macros.

This example uses PostgreSQL query syntax. You must adjust usage according to your database syntax. Also, to avoid performance issues, limit the outcome to a smaller scope if needed (using limit can help).

select s.spacekey, s.spacename, c.title as "Page Title", um.username
from content c, spaces s, user_mapping um left join cwd_user cu on um.username = cu.user_name
where c.spaceid = s.spaceid and c.contenttype = 'PAGE' and c.prevver is null and c.content_status = 'current'
and c.creator = um.user_key
and c.title in
(SELECT c.title
FROM CONTENT c
JOIN BODYCONTENT bc
    ON c.contentid = bc.contentid
JOIN SPACES s
    ON c.spaceid = s.spaceid
WHERE c.prevver IS NULL
    AND c.contenttype IN ('PAGE', 'BLOGPOST')
    AND bc.body LIKE '%ac:name="banner"%'
        or bc.body LIKE '%ac:name="composition-setup"%'
        or bc.body LIKE '%ac:name="cloak"%'
        or bc.body LIKE '%ac:name="toggle-cloak"%'
        or bc.body LIKE '%ac:name="float"%'
        or bc.body LIKE '%ac:name="show-card"%')
order by s.spacekey, c.title

3. Run the pre-migration tool

To prepare your tabbed content for the migration, you must run the Apfire pre-migration tool to convert the Deck of Cards and Card macros to Group of Tabs and Tab macros.

This is a prerequisite step for Confluence Data Center users who are planning to migrate to Confluence Cloud and have pages that use the Deck of Cards and Card macros from Composition Tabs.

Pre-migration overview
- These pre-migration steps in this article are crucial for avoiding clashes with similarly named macros on Confluence Cloud. On Cloud, there are currently Confluence-native macros that are also called Deck and Card (these are not Appfire macros). This bug report provides more details.
- As part of the migration process, an Appfire pre-migration tool is available which can rename all Deck and Card macros to Tab Group and Tab macros. On Confluence Data Center, Tab Group and Tab macros behave exactly the same way as Deck and Card macros previously do, but with a different name.
- Once this process is completed, administrators can then run the Confluence Cloud Migration Assistant to migrate all their content to Confluence Cloud.
What happens during this process?
- All content that contains Deck of Cards and Card macros, including pages and comments, will be updated to the new macro names, Tab Group and Tab.
- After the macros are renamed, your content will be displayed as it was previously. You can still view, edit and use your updated tabbed content as before on this site.

Before	After

Before	After

If new Deck of Cards and Card macros are created after the rename process, you must run the pre-migration tool again before migrating to Confluence Cloud. For example, if you have completed this process for migration test purposes, but your users continue to add new content with Deck of Cards and Card macros, you must run the tool again before performing the production migration.

Pre-cloud migration is disabled for the latest version of Composition Tabs. If you wish to migrate to cloud, it’s suggested to use v5.14.14 with Confluence 7 instead. Refer to Cannot find pre-migration tool for Composition Tabs for more information.

Go to the Confluence Admininstration console.
Under Composition Configuration, select Composition Cloud Pre-migration Tool.
Review the Composition Cloud Pre-migration Setup page.
The page diplsays the following information:
- Previous run (appears after the first run of the pre-migration tool): The date and time of the last run.
- Number of contents to update: The number of pages that still use the Deck of Cards and Card naming convention.
- Number of contents updated: Accumulated total number of pages with renamed macros.
Click Run update.
The button becomes greyed out, and a spinner indicates that the macro rename process is in progress.

The pre-migration tool runs as a background job so you can perform other tasks in your Confluence instance. If you need a more detailed status update, you can track the Confluence log file, atlassian-confluence.log. For more details, refer to How to monitor the progress of the pre-migration tool.

When the process completes:

The information on the Composition Cloud Prei-migration Setup page updates.
All updated pages have a new entry under Page History with the comment Composition Migrator: Convert Deck and Card macros to Tab & Tab Group macros.