• Documentation

Convert pages to the cloud editor

This guide provides a step-by-step process to help you convert legacy Confluence pages to the cloud editor. By converting pages to cloud, you get the latest updates and improvements to creating, collaborating, and organizing your content.

Learn more about the cloud editor

Advantages of using the cloud editor

You can elevate your content creation experience with the cloud editor's powerful features:

  • Enhanced collaboration: Work seamlessly with your team in real-time and witness edits as they happen, with changes auto-saved.

  • Faster loading: Enjoy a user-friendly interface that lets you format your content with with faster loading times.

  • Future-proofed: Benefit from ongoing updates to the cloud editor, ensuring your content remains compatible with future advancements across Atlassian products. Since the cloud editor is the unified editing experience for all Atlassian apps, you'll gain access to platform features like Atlassian Intelligence and Smart Links.

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’s the difference between the cloud and legacy toolbars?

You can see which editor your page uses by looking at the differences in the editor toolbar.

The cloud editor includes Publish… or Update and Close buttons in the top menu and the emoji icon

ConfluenceCloud_CloudEditor_Toolbar_Nov_2024

The legacy editor has earlier versions of text-color picker and page formatting

Image highlights the unique tools that make the toolbar in the legacy editor different than the one in the new editor

 

 

Convert your pages to cloud

You can convert pages to cloud while editing.

  1. Identify pages you can convert to cloud: Look for a conversion banner notification.

  2. Select Preview page in cloud.

  3. Select Convert page to proceed.

Pages that can be converted from the legacy to new editor display a notification.

For more resources check out:

Auto-convert pages to cloud in a space

Space admins can enable auto-conversion from legacy to the cloud editor for all pages with eligible content in a space.

If auto-conversion is enabled, eligible pages will be previewed in the cloud editor until published, at which point the editor is “saved.” You will be able to revert to the legacy version in page history.

To enable auto-convert:

  1. Go to the space in Confluence Cloud.

  2. Select Space settingsfrom the sidebar.

  3. Select Convert pages from the Manage space card.

  4. Toggle Convert pages automatically to the on position.

View of auto-convert editor function

If auto-conversion is not enabled, only pages that were published in the cloud editor will stay in the cloud editor.

Revert page migrations

If a migrated page does not work as expected, you can revert it back to the legacy editor.

You can also restore versions within the page’s cloud history.

Understanding conversion details

Most elements convert smoothly to the cloud editor, requiring no additional adjustments on your part. However, a few specific elements might need your attention for optimal presentation or functionality in the new environment. For more details, check out:

Understand legacy editor element conversion in Confluence Cloud

Support

The cloud editor constantly evolves, offering regular updates and improvements. To stay updated with the latest features and functionalities, check out:

  • Atlassian Community: Connect with other Confluence Cloud users and share your experiences.

  • Support articles: Access more detailed guides and troubleshooting tips for Confluence Cloud.

Still need help?

The Atlassian Community is here for you.