Content Formatting Macros for Confluence Cloud

Macros Migrated from a Server/Data Center Instance

If you are working with spaces or pages migrated from Confluence Server or Data Center to Confluence Cloud, you will be working with Confluence’s legacy editor.

Which Macros Can Be Migrated

The following Content Formatting Macros for Confluence Server marcos are supported in a migration to Confluence Cloud.

  • Button Group

  • Button Hyperlink

  • LaTeX

  • Progress Bar Container

  • Progress Bar Hyperlink Step

  • Round Rectangle

  • Tabs Page

  • Tabs Container (horizontal alignment only)

To support our customers that are migrating from Server or Data Center to Cloud, we have, where possible, added legacy versions of our macros. These macros preserve your content, but might not behave in exactly the same way as their counterparts on other platforms. We have limited, for example, the customization of these macros (macro parameters) and rather encourage those that want to continue to customize their macros, to do so on our new editor macros. Our legacy macros are always rendered in Confluence’s legacy editor. The table below outlines the Server version macros, their corresponding macros rendered following a migration to Confluence Cloud, and their editor availability.

Created in Server/DC

Rendered in Cloud

Legacy Editor

New Editor

Button Group

Button Group

check

check

Button Hyperlink

Button Hyperlink

check

check

LaTeX

LaTeX

check

check

Progress Bar Container

Progress Bar Container Legacy

check

error

Progress Bar Hyperlink Step

Progress Bar Hyperlink Step

check

check

Round Rectangle

Round Rectangle

check

check

Tabs Container & Tabs Page

Tabs Container Legacy & Tabs Page Legacy

check

error

Working with Migrated Content

In the following example, content containing the Tabs Container and Tabs Page macros was migrated from Confluence Server to Cloud.

migrate tabs
tabs legacy placeholder

To see how your macro content was rendered when migrated, follow the steps below.

  1. Navigate to a page that was migrated. Your page content is displayed.

  2. Click the Edit icon. The page is displayed in Edit mode with Confluence’s legacy editor.

  3. Macro placeholders are displayed. If legacy macros were used to preserve the content, legacy is included in the macro name, for example Tabs Page Legacy.

    Legacy macros are read-only. If they contain body content, you can amend the content or copy it to reuse elsewhere. You cannot add other macros to legacy macros.
  4. To remove the macro from the page, click the macro placeholder, then click Remove.

Using Macros with the Legacy Editor

When editing migrated pages, the legacy editor is displayed. To add macros to a Confluence page using the legacy editor select Insert > Other Macros in the Confluence editor. Alternatively, use the keyboard shortcut by typing { and the beginning of the macro name to display a list of matching macro names. To learn more about standard macro use in Content Formatting Macros for Confluence Cloud, see Macros Overview.

Which Editor Am I Using?

If you are not sure which editor is being displayed when you edit a page in Confluence, the following images may help remind you of the differences. Our macros may behave differently in edit mode according to the editor you are using, but the rendered content is consistent. For more information on the differences between the editors, see Atlassian’s Confluence Cloud Editor Roadmap.

Legacy Editor

legacy editor

Macro Placeholder in Legacy Editor

legacy-placeholder

New Editor

new editor

Macro Placeholder in New Editor

new-macro-placeholder

To learn more about using the Migration Assistant to migrate from Confluence Server or Data Center to Confluence Cloud, refer to the Atlassian Cloud documentation.