Migrating Macros
The following information applies to macros that are not nested. Confluence Cloud does not support nesting. Pages with large numbers of nested macros may not survive a migration unchanged, especially if 3rd party macros are combined with our macros. If this applies to you please contact us for support.
When you migrate a page from DC to Cloud the contents of that page including any macros are also moved. On the published version of the page, the appearance of the macros may change, and some may not be displayed at all. On the edit page, all of the content will be preserved, but the macro will be converted into one of three types.
For more guidance on how to migrate individual macros, see our Macro Migration Guides on the Mosaic Migration hub.
Migrated Macro Types
Cloud
This macro has been converted into a Cloud macro. This could be one of our macros or an Atlassian macro. These macros should work as expected for the Cloud version of the macros.
Button Hyperlink
LaTeX Formatting
Unsupported
These macros will not work on the published version of the page. The content can be accessed on the edit page.
Message Box
Macro code - auimessage
Migrated Macro Type - Unsupported
Appearance:
Comment - Replace with the native Cloud macros success, tip, error, warning, note, or info.
Restful Table
Rollover
Tooltip
Macro code - tooltip
Migrated Macro Type - Unsupported
Appearance:
Comment - This can be replaced with the Cloud Tooltip macro.
Migration guide - Here
Legacy
There is no migration path for this macro. You can see and in some cases may be able to edit the content of the of the macro. Some work as normal, some do not.
Alert
Macro code - alert
Migrated Macro Type - Legacy
Appearance:
Comment - Once migrated can no longer support rich content eg. images, links etc. Replace with the Cloud version to use.
Align
Background
Macro code - bgcolor
Migrated Macro Type - Legacy
Appearance:
Comment - No action is required, but we recommend using our Cloud Background macro on new pages for more editing options.
Migration guide - Here
Center
Clickable
Copyright
CSS Style Sheet
Dialog
Div
Fancy Bullets
Footnotes
Highlight
Macro code - highlight
Migrated Macro Type - Legacy
Appearance:
Comment - No action is required. On new pages, you can use the page Highlight Color button.
Horizontal Navigation
HTML Comment
HTML Image
iframe
Lozenge
Macro code - lozenge
Migrated Macro Type - Legacy
Appearance:
Comment - We recommend replacing this with the Cloud Advanced Cards macro.
Migration guide - Here
Ordered List
Macro code - ol & li
Migrated Macro Type - Legacy
Appearance:
Comment - If the list is more than 6 levels of indentation, then any levels greater than 6 are indented to level 6.
This can be replaced with the native list option in the editor.
Paragraph
Pre Tag
Privacy Mark and Policy
Macro code - privacy-mark & privacy-policy
Migrated Macro Type - Legacy
Appearance:
Comment - The Privacy Policy link will no longer create a page if one doesn't already exist.
Progress Bar
Registered Trademark
Round Rectangle
Macro code - roundrect
Migrated Macro Type - Legacy
Appearance:
Comment -
No action is required. For new pages, you may want to try our Cloud Background or Advanced Cards macros.
Search Box
Service Marks
Span
Strikethrough
Table Layouts
Macro code - table, td, & tr
Migrated Macro Type - Legacy
Appearance:
Comment - This can be replaced with the native table from the Cloud editor.
Tabs
Macro code - auitabspage & auitabs
Migrated Macro Type - Legacy
Appearance: All migrated tabs work with lazy loading, which means the content only loads when you first open the tab.
Comment - No action is required. We recommend moving to the Cloud Tabs macro for more options and a smoother user experience.
Migration guide - Here
Trademark
Unordered List
Macro code - ul & li
Migrated Macro Type - Legacy
Appearance:
Comment - If the list is more than 6 levels of indentation then any levels greater than 6 are indented to level 6.
This can be replaced with the native list option in the editor.