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.

Migrated Macro Types

Select the macro names to expand for more information.

Cloud  

This macro has been converted into a Cloud macro. This could be one of our macros or an Atlassian macro. These macros will work if you convert the page to the Cloud editor.

Macro code - bibtex-referencing

Migrated Macro Type - Cloud

Appearance: Unchanged

Comment - No is action required

Macro code - auibuttongroup

Migrated Macro Type - Cloud

Appearance: Unchanged

Comment - No is action required

Macro code - auibutton

Migrated Macro Type - Cloud

Appearance: 

Comment - No action is required

Macro code - latex-formatting

Migrated Macro Type - Cloud

Appearance: Unchanged

Comment No action is required

Unsupported  

These macros will not work on the published version of the page in either the Legacy or Cloud editor. The content can be accessed on the edit page.

Macro code - auimessage

Migrated Macro Type - Unsupported

Appearance:

 

Comment - Replace with the native Cloud macros success, tip, error, warning, note, or info.

Macro code - rest-table

Migrated Macro Type - Unsupported

Appearance: 

Macro code - rolloverwithoutbody

Migrated Macro Type - Unsupported

Appearance: 

Macro code - tooltip

Migrated Macro Type - Unsupported

Appearance: 

Comment - This can be replaced with the Cloud Tooltip macro.

Legacy 

There is no migration path for this macro. You can see and edit the content of the DC version of the macro, but this macro will not be editable if you convert the page to the Cloud editor. Some work as normal in the legacy editor some do not.

Macro code - alert

Migrated Macro Type - Legacy

Appearance:

Comment - Can’t be edited when the page is converted to the Cloud editor. Replace with the Cloud version to use with the Cloud Editor.

Macro code - align

Migrated Macro Type - Legacy

Appearance: Unchanged

Comment - No action is required.
Once converted to the Cloud editor, you can add more text but you can’t change the alignment. To change the alignment, copy the content and paste it onto the page, then use the page’s alignment buttons.

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.

Macro code - center

Migrated Macro Type - Legacy

Appearance: Unchanged

Comment - No action is required.
Once converted to the Cloud editor, you can add more text. On new pages, you can use the page Center button.

Macro code - clickable

Migrated Macro Type - Legacy

Appearance: Depends on what it contains, but usually unchanged. However, the clickable functionality does not work.

Comment - Replace with a Button or Advanced Cards macro.

Macro code - copyright

Migrated Macro Type - Legacy

Appearance: Unchanged

Comment - No action is required. On new pages add a copyright image, emoji, or symbol.

Macro code - style

Migrated Macro Type - Legacy

Appearance:N/A

Comment - In the Legacy editor this macro often continues to work, but more complex uses may not be supported. Its effects do not persist in the Cloud editor.
Styling of macros and page elements is now done on an individual level.

Macro code - auidialog

Migrated Macro Type - Legacy

Appearance: This macro often continues to work, but more complex uses may not be supported. Dialogs launched from hyperlinks do not work at all.

Comment - Replace with the Cloud Pop-up Dialog

Macro code - div

Migrated Macro Type - Legacy

Appearance: Usually unchanged. If combined with a CSS Style Sheet macro then results may vary.

Comment - No action is required. Once converted to the Cloud editor, you can add more text. If it is combined with a CSS Style Sheet macro the div becomes unsupported in the Cloud editor.

Macro code - fancy-bullets

Migrated Macro Type - Legacy

Appearance: Standard bullets are unchanged, but custom images can have unpredictable results.

Comment - No action is required. When converting to the Cloud editor, the following styles are not fully supported - Circle, CJK Ideographic, Katakana, Hiragana, Hiragana-iroha, Katakana-iroha.

Macro code - footnote & display-footnotes

Migrated Macro Type - Legacy

Appearance: Unchanged.

Comment - Does not work as expected in the Cloud editor. Replace with the Cloud Footnote macro to use in the Cloud Editor.

Macro code - highlight

Migrated Macro Type - Legacy

Appearance: 

Comment - No action is required. On new pages, you can use the page Highlight Color button.

Macro code - auihorizontalnav & auihorizontalnavpage

Migrated Macro Type - Legacy

Appearance: Unchanged

Comment - No action is required, however, this macro will not work when converted to the Cloud editor. We recommend using our Cloud Tabs macro on new pages.

Macro code - htmlcomment

Migrated Macro Type - Legacy

Appearance: N/A

Comment - No action is required. Cannot be edited in the Cloud Editor.

Macro code - img

Migrated Macro Type - Legacy

Appearance: Usually unchanged.

Comment - No action is required.

Macro code - iframe

Migrated Macro Type - Legacy

Appearance: Usually unchanged, but size may change.

Comment - No action is required.

Macro code - lozenge

Migrated Macro Type - Legacy

Appearance: 

Comment - We recommend replacing this with the Cloud Advanced Cards macro.

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.

Macro code - p 

Migrated Macro Type - Legacy

Appearance:  No change

Comment - No action is required. Once converted to the Cloud editor, you can add more text. If it is combined with a CSS Style Sheet macro the paragraph macro becomes unsupported in the Cloud editor.

Macro code - pre

Migrated Macro Type - Legacy

Appearance:  Usually unchanged.

Comment - No action is required. Once converted to the Cloud editor, you can add more text.

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.

Macro code - auiprogressstepstatic & auiprogress

Migrated Macro Type - Legacy

Appearance: 

Comment - 

No action is required. Replace with the Cloud Progress Bar macro when converting to the Cloud editor.

Macro code - reg-tm

Migrated Macro Type - Legacy

Appearance: Unchanged

Comment - No action is required. On new pages add a trademark image, emoji or symbol.

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.

Macro code - search-box

Migrated Macro Type - Legacy

Appearance: 

Comment - No action is required.

Macro code - sm

Migrated Macro Type - Legacy

Appearance: Unchanged

Comment - No action is required. On new pages add a trademark image, emoji, or symbol.

Macro code - span

Migrated Macro Type - Legacy

Appearance:  Usually unchanged. If combined with a CSS Style Sheet macro then results may vary,

Comment - No action is required. Once converted to the Cloud editor, you can add more text. If it is combined with a CSS Style Sheet macro the span becomes unsupported in the Cloud editor.

Macro code - strike

Migrated Macro Type - Legacy

Appearance:  The text is displayed as normal text - no strike is applied

Comment - You can use the Strikethrough option in the Cloud editor.

Macro code - table, td, & tr

Migrated Macro Type - Legacy

Appearance: 

Comment - This can be replaced with the native table from the Cloud editor.

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 in the Cloud Editor for more options and a smoother user experience.

If you are working in the legacy editor you can only use the older version of the Cloud Legacy Tabs macro.

Macro code - tm

Migrated Macro Type - Legacy

Appearance: Unchanged

Comment - No action is required. On new pages add a trademark image, emoji, or symbol.

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.


On this page