Migrate to Cloud

Learn more about migration to Cloud and what to expect for your content and macros.

We have worked closely with Atlassian and their new cloud editor to help you move your valuable Confluence content to Confluence Cloud. Many of our DC/Server macros are directly supported in migration to Confluence Cloud. Simply use Atlassian’s migration assistant. We have developed Cloud versions of some of our Server macros, allowing you to preserve and modify your content. We are continuing to work to bring more of your favorite macros to Cloud.

The most important thing is your content, so the migration process preserves that. However, the appearance of the macros may change. Some macros do not currently have a migration path, so they will not display on the view page. In these cases, you will still be able to access all of the content on the edit mode of your page.

There are four possibilities for what happens to your Content Formatting Macros:-

Converted to Cloud versions of the same macro. This means you get the newest version of our macros. You will be able to edit the parameters and add new ones.
Converted to Atlassian macros so you can edit the macro parameters. This means you do not need one of our macros, as there is a native confluence macro/function to serve the same purpose which is used instead.
Converted to Legacy macros, so are view only.
They are not supported, so an "unknown macro" image is displayed on the view page. But you can access the content on the edit page.

What happens with each Macro

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

In the table below, you can check what will happen to each macro when it is migrated and what the most likely appearance will be. Using this information can help you to prepare for migrating your content.

CFMC Server/DC Macro	Support	Atlassian/ Cloud/ Legacy	Appearance	Options For Editing
Alert		Legacy		Add a new Alert macro to the page.
Align		Atlassian	Same as DC/Server	Editable
Background Color		Atlassian	If you have used color names, they may appear as different shades.	Editable in the legacy editor. In the new editor, add a Background Macro to the page.
BibTeX Display Table/ Summary		Cloud	Same as DC/Server	n/a
BibTeX Referencing		Cloud	Same as DC/Server	Editable. The macros become Cloud BibTex macros.
Button Group		Cloud	Same as DC/Server	Editable. The macros become Cloud B utton Group macros.
Button (Hyperlink)		Cloud	The colors will change slightly, but you can easily change them from the macro editor. Any custom icons will be removed.	Editable. The macros become Cloud B utton macros.
Center Content		Atlassian	Same as DC/Server	Editable
Clickable		Atlassian	The contents of the clickable macro will be presented without the clickable element.	Depending on your needs, you might want to try our Card macro.
Colgroup Tag		Atlassian	The contents of the Colgroup macro will be presented.	This feature has been deprecated due to the loss of functionality in modern browsers.
Copyright		Atlassian	Same as DC/Server	Editable
CSS Style Sheet		Atlassian	n/a	While in the legacy editor, you can still edit this macro. Once you convert to the Cloud editor, you will no longer be able to make changes, but the effect will persist.
Dialog		Legacy	For dialogs triggered using a button macro, they will appear and work the same as on DC/Server. This includes buttons and links inside the dialogs. Dialogs triggered by hyperlinks are not supported. The content can still be found on the edit page.	Replace with the Cloud Pop-up Dialog
Div		Atlassian	Same as DC/Server.	Editable
Fancy Bullets		Atlassian	Same as DC/Server, but it may not work as expected if you have a custom image.	Editable
Footnote		Legacy	Should work as expected with text and images. However, results may vary if other macros are inside the footnote.	Replace with the Cloud Footnote macros.
Footnotes Table		Legacy	Should work as expected with text and images. However, results may vary if other macros are inside the footnote.	Replace with the Cloud Footnote macros.
Highlight		Atlassian	If you have used color names, they may appear as different shades.	Editable
Horizontal Nav		Legacy		Add new Legacy Tabs macros to the page.
HTML Comment		Atlassian	Appears to work as on DC/Server, but Atlassian has not documented it, so results may vary.
HTML Image		Atlassian	Appears to work as on DC/Server, but Atlassian has not documented it, so results may vary.
Iframe		Atlassian	Same as DC/Server.	Editable
LaTeX		Cloud	Same as DC/Server.	Editable. The macro becomes a Cloud LaTeX macro.
List Item		Atlassian	Atlassian's macro is known to add <p> tags to content.	Editable
Lozenge		Atlassian	The content is retained, but the appearance is a little unpredictable.	Depending on your needs, you might want to try our Card macro.
Message Box			View page Edit page	Depending on your needs, you might want to try the Atlassian Cloud message boxes.
Ordered List		Atlassian	Atlassian's macro is known to add <p> tags to the list of items used with this macro.	Editable
Paragraph		Atlassian	Same as DC/Server.	Editable
Pre Tag		Atlassian	Same as DC/Server.	Editable
Privacy Mark		Atlassian	Same as DC/Server.	Editable
Privacy Policy		Atlassian	The icon is different. The Privacy Policy link will no longer create a page if one doesn't already exist.	Editable
Progress Bar Container and Progress Bar (Hyperlink Step)		Legacy	May display with a vertical scroll bar.	Add new Progress Bar macros to the page.
Registered Trademark		Atlassian	Same as DC/Server.	Editable
Restful Table				Currently, nothing comparable on Cloud.
Rollover				Currently, nothing comparable on Cloud.
Round Rectangle		Atlassian	Same as DC/Server. Once migrated all tabs will us	Atlassian has deprecated this macro. Depending on your needs, you might want to try our Background macro.
Search Box		Atlassian		Editable
Service Marks		Atlassian	Same as DC/Server.	Editable
Span Tag		Atlassian	Same as DC/Server.	Editable
Strike Text		Atlassian	The contents of the Strike Text macro will be presented without the strikethrough.	Editable
Table Layouts		Atlassian	The contents of the Table macros will be presented without the table.	Use the tables in the Confluence Cloud editor.
Tabs Container and Tabs Page		Legacy	Same as DC/Server. Once migrated, all tabs use lazy loading. This means each tab only loads when opened.	Add new Legacy Tabs macros to the page.
Tooltip				Add new Tooltip macros to the page.
Trademarks		Atlassian	Same as DC/Server.	Editable
Unordered List		Atlassian	Atlassian's macro is known to add <p> tags to the list item macros used with this macro.	Editable

For a more visual guide to how migration will affect your macros why not check out our Cloud Migration Guide.

help Contact Support

approve Try it now