Understanding legacy editor element conversion in Confluence Cloud
This article provides a comprehensive overview of how elements from your legacy editor pages are converted when you migrate to the Confluence cloud editor.
If you continue to use the legacy editor
You will continue to have the option to update pages in the legacy editor. However, there are some downsides to continuing to use the legacy editor:
No bugs fixed in the legacy editor unless it's a major incident.
No enhancements made to the legacy editor.
What to Expect
Most elements convert seamlessly: You won't need to make any adjustments to most content after the conversion.
Some elements require attention: This article focuses on elements with specific conversion behaviors, categorized into two sections:
Elements that can't be converted: The cloud editor currently does not support these elements. We provide information on alternative approaches and solutions within the cloud editor and our plans for future support.
Elements with modifications after conversion: These elements convert but may require minor adjustments to ensure optimal presentation or functionality in the cloud editor. We detail the specific changes and offer guidance on how to address them.
Elements that can’t convert
Legacy editor elements | Category | What happens when converted? |
|---|---|---|
Background color macro | Macro | Can’t convert (reference CONFCLOUD-68492) The text inside the macro is brought over to the converted page, but the background color is removed. |
Comment (inline on an image) | Page interaction | Can’t convert (reference CONFCLOUD-67745) There is no way to show the comment in the new editor, yet. |
Image with an effect | Presentation | Can’t convert (reference CONFCLOUD-67122) Effects are removed and can't be reapplied. |
Image with title text | Presentation | Can’t convert (reference CONFCLOUD-67122) Title text is removed and can't be reapplied. |
Links to headings on a different page | Navigation | Can’t convert The link navigates you to the page but not to the heading specified. |
Links to headings on the same page | Navigation | Can’t convert The text is maintained, but the link to the heading is broken. |
Macro inside a list | Macro | Can’t convert (reference CONFCLOUD-67862) |
Table in a list | Presentation | Can’t convert (reference CONFCLOUD-58656) This could be accomplished in earlier versions of the legacy editor and can't be converted to the new editor. |
Table in a table | Presentation | Can’t convert (reference CONFCLOUD-58656) This could be accomplished in earlier versions of the legacy editor and can't be converted to the new editor. |
Task list containing a horizontal rule | Presentation | Can’t convert (reference CONFCLOUD-68515) |
Task list containing a macro | Presentation | Can’t convert (reference CONFCLOUD-67862) Task lists containing the Jira issue macro converts without issue. Other macros, like Questions List and Children Display, can't convert. |
Task list containing a table | Presentation | Can’t convert (reference CONFCLOUD-58656) Could be accomplished in earlier versions of the legacy editor, and can't be converted to the new editor. |
Task list containing any paragraph style (H1 through H6, Preformatted, Quote, Monospace) | Presentation | Can’t convert (reference CONFCLOUD-68499) The new editor does not allow these styles to be applied in task lists. |
Elements with modifications after conversion
Legacy editor elements | Category | What happens when converted? |
|---|---|---|
Align macro | Macro | Converts completely Even though this macro was removed from the new editor and replaced with toolbar actions, the macro and its settings are carried over to the new editor. The settings can’t be changed in the new editor. The content in the body of the macro can be edited. |
Center macro | Macro | Converts completely Even though this macro was removed from the new editor and replaced with toolbar actions, the macro and its settings are carried over to the new editor. The settings can’t be changed in the new editor. The content in the body of the macro can be edited. |
Cheese macro | Macro | Converts completely Even though this macro was removed from the new editor, the conversion removes the macro and replaces it with the text, "I like cheese". |
Code block macro | Macro | Converts with modification This macro was removed from the new editor and replaced with the Code Snippet element (type /code). Conversion removes the Code Block macro, moves the text into a Code snippet element, and allows you to choose the appropriate language. |
Column (single) | Presentation | Converts with modification (reference CONFCLOUD-67198) The single-column layout option was removed in the new editor. Conversion removes the single column and makes all the content within fixed-width. |
Column macro | Macro | Converts completely The macro and its settings are carried over to the new editor. The settings can’t be changed in the new editor. The content in the body of the macro can be edited. New layouts can be created in the new editor using the Layouts tool in the toolbar. |
Content by user macro | Macro | Converts completely (reference CONFCLOUD-33832) The macro and its settings are carried over to the new editor. The settings can’t be changed in the new editor. |
Copyright macro | Macro | Converts completely (reference CONFCLOUD-68495) The macro and its settings are carried over to the new editor. The settings can’t be changed in the new editor. The content in the body of the macro can be edited. |
Create space button macro | Macro | Converts completely (reference CONFCLOUD-68494) The macro and its settings are carried over to the new editor. The settings can’t be changed in the new editor. |
Div macro | Macro | Converts completely (reference CONFCLOUD-65774) The macro and its settings are carried over to the new editor. The settings can’t be changed in the new editor. The content in the body of the macro can be edited. |
Expand macro | Macro | Converts completely The macro is replaced by the new element. Your heading and content are unchanged. |
Fancy bullets macro | Macro | Converts completely (reference CONFCLOUD-68496) The macro and its settings are carried over to the new editor. The settings can’t be changed in the new editor. The content in the body of the macro can be edited. |
Favorite pages macro | Macro | Converts completely (reference CONFCLOUD-68497) The macro and its settings are carried over to the new editor. The settings can’t be changed in the new editor. |
File shown as thumbnail | Presentation | Converts completely (reference CONFCLOUD-67512) Conversion is completed after a page refresh is performed. |
Global reports macro | Macro | Converts completely (reference CONFCLOUD-68498) The macro and its settings are carried over to the new editor. The settings can’t be changed in the new editor. |
Headings 1 through 6 applied to an item in a list | Text style | Converts with modification (reference CONFCLOUD-68499) Doesn't preserve the formatting from the legacy editor, but a new formatting scheme is applied to visually differentiate between the levels:
|
Highlight macro | Macro | Converts completely (reference CONFCLOUD-68517) Even though this macro was removed from the new editor, the macro and its settings are carried over to the new editor. The settings can’t be changed in the new editor. The content in the body of the macro can be edited. |
Horizontal rule in a list | Presentation | Converts with modification Horizontal rule is given its own line below the list. |
HTML comment macro | Macro | Converts completely (reference CONFCLOUD-65854) Even though this macro was removed from the new editor, the macro and its settings are carried over to the new editor. The settings can’t be changed in the new editor. The content in the body of the macro can be edited. |
IM presence macro | Macro | Converts completely (reference CONFCLOUD-68500) Even though this macro was removed from the new editor, the output of the macro is carried over to the new editor. The settings can’t be changed in the new editor. |
Image as a list item (on its own line) | Presentation | Converts completely Image is maintained as a list item. |
Image inline in a list | Presentation | Converts with modification (reference CONFCLOUD-67862) Line breaks are added before and after the image placing the image on its own line. Images can't be placed in a sentence in the new editor. |
Image inserted into a sentence | Presentation | Converts with modification (reference CONFCLOUD-68501) Line breaks are added before and after the image placing the image on its own line. Images can't be placed in a sentence in the new editor; however, you can create a custom emoji for icons or other small images to be inserted into the flow of a sentence. |
Image inserted into a table | Presentation | Converts with modification (reference CONFCLOUD-66401) The image converts, but the spacing and sizing of the image may differ. |
Image inserted on it own line | Presentation | Converts with modification The image converts, but the spacing and sizing of the image may differ. |
Image with a border | Presentation | Converts with modification (reference CONFCLOUD-67122) Borders are removed. Borders can be applied using the new editor's image annotation feature. |
Image with a link | Presentation | Converts completely After conversion, the link can’t be modified in the new editor. |
Image with a specific pixel size | Presentation | Converts with modification (reference CONFCLOUD-67554) Images in the new editor align to a grid. The grid size closest to the pixel size is applied, and the image is centered on the page. |
JUnit report macro | Macro | Converts completely (reference CONFCLOUD-65317) Even though this macro was removed from the new editor, the macro and its settings are carried over to the new editor. The settings can’t be changed in the new editor. |
Links to anchors | Navigation | Converts completely (reference CONFCLOUD-66773) When converted, the link to the anchor location still works but the Anchor macro is invisible. |
Lists, bulleted (created with the Fancy bullets macro) | Structure | Converts completely Even though this macro was removed from the new editor and replaced with toolbar actions, the macro and its settings are carried over to the new editor. The settings can’t be changed in the new editor. The content in the body of the macro can be edited. |
Lists, bulleted (more than 6 levels) | Structure | Converts with modification The new editor only allows lists with 6 levels, so the conversion of levels 1 through 6 are handled without issue. Levels 7 and deeper are outdented to level 6. |
Lists, numbered (more than 6 levels) | Structure | Converts completely The new editor only allows lists with 6 levels, so the conversion of levels 1 through 6 are handled without issue. Levels 7 and deeper are outdented to level 6. |
Loremipsum macro | Macro | Converts completely (reference CONFCLOUD-68502) Even though this macro was removed from the new editor, the macro and its settings are carried over to the new editor. The settings can’t be changed in the new editor. |
Macro in a task | Nested elements | Converts with modification Tasks with certain macros can be converted, like the Jira Issue macro; however, others can't like the Children Display macro. |
Monospace text | Text style | Converts with modification Converts the text as monospace and retains whatever text color was applied. However, a grey background is applied to the text. |
Multimedia macro | Macro | Converts completely Even though this macro was removed from the new editor, the macro and its settings are carried over to the new editor. The settings can’t be changed in the new editor. |
Navigation map macro | Macro | Converts completely Even though this macro was removed from the new editor, the macro and its settings are carried over to the new editor. The settings can’t be changed in the new editor. |
Network macro | Macro | Converts completely Even though this macro was removed from the new editor, the macro and its settings are carried over to the new editor. The settings can’t be changed in the new editor. |
Noformat macro | Macro | Converts with modification (reference CONFCLOUD-68503) This macro was removed from the new editor and replaced with the Code Snippet element (type /code). Conversion removes the Noformat macro, moves the text into a Code Snippet element, and allows you to choose the appropriate language. |
Note macro | Macro | Converts with modification Conversion removes the specific, unitasking macro, replaces it with the Info Panel element, and assigns the appropriate background color and icon; there is no option in the new element to remove the icon. |
Panel macro | Macro | Converts completely (reference CONFCLOUD-66752) The macro and its settings are carried over to the new editor. The settings can’t be changed in the new editor. The content in the body of the macro can be edited. Paragraph styles applied to text in the panel are maintained. |
Panel macro containing another macro | Macro | Converts completely (reference CONFCLOUD-66888) The macro and its settings are carried over to the new editor. The settings can’t be changed in the new editor. The content in the body of the macro can be edited. Paragraph styles applied to text in the panel are maintained. |
Panel macro with text formatted as a heading | Macro | Converts completely (reference CONFCLOUD-66752) The macro and its settings are carried over to the new editor. The settings can’t be changed in the new editor. The content in the body of the macro can be edited. Paragraph styles applied to text in the panel are maintained. |
Panel macro with text formatted with the Preformatted style | Macro | Converts completely (reference CONFCLOUD-66752) The macro and its settings are carried over to the new editor. The settings can’t be changed in the new editor. The Preformatted paragraph style remains as it was in the legacy editor. |
Panel macro with text formatted with the Quote style | Macro | Converts completely (reference CONFCLOUD-66752) The macro and its settings are carried over to the new editor. The settings can’t be changed in the new editor. The content in the body of the macro can be edited. Paragraph styles applied to text in the panel are maintained. |
Preformatted text style | Text style | Converts with modification (reference CONFCLOUD-59714) This paragraph style is modified during conversion. The formatting will be changed to superscript. |
Privacy mark macro | Macro | Converts completely (reference CONFCLOUD-68504) Even though this macro was removed from the new editor, the macro and its settings are carried over to the new editor. The settings can’t be changed in the new editor. |
Privacy policy macro | Macro | Converts completely Even though this macro was removed from the new editor, the macro and its settings are carried over to the new editor. The settings can’t be changed in the new editor. The content in the body of the macro can be edited. |
Recently used labels macro | Macro | Converts completely (reference CONFCLOUD-68506) Even though this macro was removed from the new editor, the macro and its settings are carried over to the new editor. The settings can’t be changed in the new editor. |
Registered trademark macro | Macro | Converts completely (reference CONFCLOUD-68507) Even though this macro was removed from the new editor, the macro and its settings are carried over to the new editor. The settings can’t be changed in the new editor. |
Search results macro | Macro | Converts completely (reference CONFCLOUD-67827) Even though this macro was removed from the new editor, the macro and its settings are carried over to the new editor. The settings can’t be changed in the new editor. |
Section macro | Macro | Converts completely (reference CONFCLOUD-68508) Even though this macro was removed from the new editor, the macro and its settings are carried over to the new editor. The settings can’t be changed in the new editor. The content in the body of the macro can be edited. |
Service mark macro | Macro | Converts completely (reference CONFCLOUD-68509) Even though this macro was removed from the new editor, the macro and its settings are carried over to the new editor. The settings can’t be changed in the new editor. |
Shared links bookmarklet button macro | Macro | Converts completely (reference CONFCLOUD-68510) Even though this macro was removed from the new editor, the macro and its settings are carried over to the new editor. The settings can’t be changed in the new editor. |
Space attachments macro | Macro | Converts completely (reference CONFCLOUD-60005) Even though this macro was removed from the new editor, the macro and its settings are carried over to the new editor. The settings can’t be changed in the new editor. |
Space details macro | Macro | Converts completely (reference CONFCLOUD-68511) Even though this macro was removed from the new editor, the macro and its settings are carried over to the new editor. The settings can’t be changed in the new editor. |
Span macro | Macro | Converts completely (reference CONFCLOUD-65321) Even though this macro was removed from the new editor, the macro and its settings are carried over to the new editor. The settings can’t be changed in the new editor. The content in the body of the macro can be edited. |
Status macro | Macro | Converts completely The macro is replaced by the new element that is available from the insert menu or a slash command (type /status). |
Status macro with outline style | Presentation | Converts with modification (reference CONFCLOUD-68512) Macro is converted to a new element, but the outline style is removed as it is not available in the new editor. |
Strike macro | Macro | Converts completely (reference CONFCLOUD-68514) The macro that used red sketchy lines is removed, and standard strikethrough formatting is applied to the text. |
Style macro | Macro | Converts completely (reference CONFCLOUD-65321) The macro and its settings are carried over to the new editor. The settings can’t be changed in the new editor. The content in the body of the macro can be edited. |
Symbols | Presentation | Converts completely (reference CONFCLOUD-67811) Even though symbols were removed from the new editor, symbols are converted without issue. To insert standard symbols into your content, consult the keyboard shortcuts available for your computer's operating system. |
Table, basic | Presentation | Converts with modification The cell height of the converted table differs. |
Table of content zone macro containing another macro | Presentation | Converts completely This works when block macros are inserted; rich body macros inserted into the TOC Zone macro can't be converted. |
Table that is fixed-width | Presentation | Converts with modification Converts the table, but the column and text won't be the same. The new editor offers fixed-width, wide width, and full-width. |
Table that is responsive | Presentation | Converts with modification Converts the table, but the column and text won't be the same. The new editor offers fixed-width, wide width, and full-width. |
Task list containing an element | Presentation | Converts completely Elements include Code snippet, Date, Decision, Expand, Quote, Status |
Text with color applied | Text style | Converts completely The conversion preserves the color even if the color doesn't exist in the new editor; if you edit the color in the new editor, you can only select from the eight available colors. |
Text with indents | Presentation | Converts completely (reference CONFCLOUD-67176) The toolbar controls for indent and outdent were removed in the new editor. Use Tab to indent and Shift + Tab to outdent. |
Text with outdents | Presentation | Converts completely (reference CONFCLOUD-67176) The toolbar controls for indent and outdent were removed in the new editor. Use Tab to indent and Shift + Tab to outdent. |
Tip macro | Macro | Converts completely (reference CONFCLOUD-68516) Conversion removes the specific, unitasking macro, replaces it with the Info Panel element, and assigns the appropriate background color and icon; there is no option in the new element to remove the icon. |
Trademark macro | Macro | Converts completely (reference CONFCLOUD-68507) Even though this macro was removed from the new editor, the macro and its settings are carried over to the new editor. The settings can’t be changed in the new editor. |
Warning macro | Macro | Converts completely (reference CONFCLOUD-67577) Conversion removes the specific, unitasking macro, replaces it with the Info Panel element, and assigns the appropriate background color and icon; there is no option in the new element to remove the icon. |
Widget connector macro | Macro | Converts completely (reference CONFCLOUD-67611) In the legacy editor, pasting a link to a video onto the page would automatically add this widget that would contain the video |