Composition Tabs for Confluence feature differences

Data Center

Cloud

Migration Path is available

Needed

• Understand the feature differences (see below) between the app for Confluence Data Center and the app for Confluence Cloud.

• Allocate time for a test migration to understand the steps required to migrate data and complete re-configuration.

• This guide assumes you have successfully migrated your Confluence DC data into Confluence Cloud, per Atlassian's instructions (CCMA). More Atlassian resources are available here.

Versioning/License

Version support

Minimum migratable version: 5.14.1

Migrate to Composition Tabs Cloud using the steps at Migration Path.

License

Available through Atlassian Marketplace.

Available through Atlassian Marketplace only. Monthly subscriptions are the default option; however, discounted annual subscriptions are available upon request to our Atlassian Sales team.

Confluence Differences

Integration with other macros

Composition Tabs allows

• Integration with other macros.

• Support of nested macros, which means Composition Tabs macros can easily be nested and integrated with other Confluence native macros or any third-party macros.

Composition Tabs macros in the cloud have the following limitations:

• Does not support nested macros, which means Composition Tabs macros cannot be placed in a nested container (such as inside an expand macro, etc.)

• Due to the above, integration with other macros may be difficult.

Macros availability

Data Center macros

Cloud macros 

• Only some macros are available in cloud.

• Look out for icons highlighting how the data will be migrated.

  •  – Available 

  •  – Unavailable

  •  – Partially available

• Migration for the following Composition Tabs macros is possible.

  • Migration for Showcase macros works out of the box.

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

    • These will be converted to Tab Group & Tab (legacy editor) macros first

    • Then you can choose to convert to Tabs (new editor) at a later point

  • Other Composition macros not available in Cloud can still be migrated without data loss; however, the following conditions apply:

    • You may see a blank space where the macros were originally positioned in the documents.

    • While these macros do 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.

• Find details of each migratable macro below, and the differences in terms of behavior once migrated to cloud.

• Card 

• Deck of Cards 

• Cloak 

• Composition Setup 

• Float 

• Page Banner 

• Show Card 

• Showcase 

• Toggle Cloak 

• Showcase

• Tabs

• Tab Group

• Tab

• Pages to Tabs

Supported Data Center macro

Cloud macro (or closest equivalent ) 

Data Center

Cloud

• Card

• Deck of Cards

• Tab

• Tab Group

• Tabs

Deck of Cards and Cards

• In Data Center, tabbed content is available by calling the Cards macro nested inside the Deck of Cards macro.

• You add the content of each tab inside each Card macro body.

Open

 Notes about Cloud migration

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

  • During the migration, these macros are converted to Tab Group and Tab (Legacy editor) macros.

  • Later, after the migration, you can convert them to the Tabs (New editor) macro.

  • Refer to Legacy editor vs New editor to understand the background behind each of these versions of Confluence editors.

Tabs, Tab Group, and Tab

Confluence Cloud has two different editors. For details, see Legacy editor vs New editor.

Composition Tabs has a different set of macros for each type of editor:

• Macros available in the Legacy editor: Tab and Tab Group

  • In Confluence Cloud’s Legacy editor, tabbed content is available by calling the Tab macros nested inside a Tab Group macro.

  • You add the content of each tab inside each Tab macro body. See Incompatible macros when nested within Composition Cloud's Tab and Tab Group macros.
    

• Macro available in the New editor: Tabs

  • In Confluence Cloud’s New editor, tabbed content is available by calling the Tabs macro

  • You add the content of each tab inside the Tabs editor.

    Open

    

• New editing experience in Confluence Cloud does not support nested body macros (CONFCLOUD-68323)

• Tab Group and Tab macros that utilize nested macros mechanism will not work properly in New Editor.

Showcase 

Showcase

Parameters available:

• Title

• Description

• Image URL

• Button Text

• Button Link

Parameters available:

• Title

• Description

• Image

• Emoji

• Button Text

• Button

• Badge

 Notes about Cloud migration

A number of parameters have different names in the Cloud version, but they work the same way as the Data Center version parameters. Data Center parameter names are automatically converted to the Cloud parameter names during the migration.