FAQ on Confluence Server to Confluence Cloud migration

I want to migrate  Composition Tabs for Confluence to the cloud. Are there anything I need to know before doing the migration?

Only some macros in Composition Tabs for Confluence are available in Cloud:

• Showcase macro is available in Cloud

• There are two different macros for Tabbed Content available in Cloud

  • Tab Group & Tab (Legacy Editor)

  • Tabs (New Editor)

 Only some macros can be migrated to Cloud:

• Migration for Showcase macros works out of the box.

• Deck of Cards & Card can be migrated after performing the mandatory pre-migration steps.

• Other Composition macros not available in Cloud can still be migrated without data loss (read more below).

What happens to the macros / parameters that are not available in Cloud? Will my data be lost?

• While these macros / parameters does not have any output and the values are ignored in Cloud, all data will be retained. Some of the macros will be coming to Cloud in future releases.

• After the migration, all the unavailable macros in View Page mode will be hidden to prevent you from getting the "Unknown macro" errors.

How do I migrate the app to Cloud?

1. Tabbed content macros (Deck of Cards and Card) have to be converted to Tab Group and Tab macros first by following this guide.

2. Once that's done, migrate your content with the Cloud Migration Assistant by Atlassian. All the app data will be migrated automatically.

Will the position of the Tab Groups macro remain the same post-migration to Confluence Cloud.

When switching Tab Groups to Tabs macros:

• Top position will remain as top.

• Left position will remain as left (known as "side" position in Tabs macro)

• Right position will not remain as it is and instead be converted to top position in Tabs macro. 

How do I access data from these legacy macros or specific macro parameters?

Legacy macros:

• You can access the data by accessing the page's storage format by choosing   >  View Storage Format . 

Do I have to do anything to make these data available once the macro feature has been made fully supported in Cloud in future?

These functions will automatically pick up the migrated data and work automatically.

Are there any special cases that I need to be aware of?

Yes. please see below:

• The content inside Tab Group and Tab macros may not be displayed the same way in Cloud as they were in Server. For example, if the macro contains elements that are not supported in Cloud, it will not be displayed properly in Cloud. This page contains a list of Incompatible macros when nested within Composition Cloud's Tab and Tab Group macros.

• Similarly, if the macro contains a third-party macro, you’ll still need to install that first.

Can I expedite or influence a delivery of a macro or function I need in cloud?

Yes, please contact our Support team to know more about this.