The new editor has loads of great improvements, and we redesigned other features to:
Support more use cases
Solve deeper problems
Make them easier to master
The new editor has many features you’ll recognize, and we’re working to add more new features. However, not all features that were in the legacy editor will be in the new editor. We'll evaluate features on a case-by-case basis to decide if some of the discontinued features from the legacy editor will be brought into the new experience.
Keep in mind that you'll have the option to continue to create 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
All new features and enhancements are made to the the new editor.
If you have a Confluence instance full of pages created using the legacy editor, you have the option to convert those pages to the new editor. We won’t be converting your pages for you because we know that you know your content best and can decide when it’s the best time to convert your content.
Since there are some differences in the capabilities available in the legacy editor and those in the new editor, we want to make it abundantly clear what will happen to your content when you convert a page.
Our goal is to allow you to convert your pages from the legacy editor to the new editor without data loss and with little to no changes to the look and feel of the content.
When the page conversion functionality is available in your Confluence instance, you can pick and choose which pages get converted and when. You'll also have the option to preview any page before converting it. We want you to feel comfortable with the process. You'll also have the chance to restore a page to its previous, legacy editor version after conversion.
To learn more about the page conversion process, go to Converting pages to the new editor.
How do you know which editor a page uses?
When you edit a page, you can scan the toolbar for visual indicators like the text color picker or the emoji icon. Also, the location of the Publish and Close buttons were consolidated at the top right of the new editor.
Legacy editor
New editor
Feature comparison
The new editor has loads of great improvements. When improvements are made, you replace things and get rid of others. Many familiar features are available in the new editor, some are being worked on, and others won't be available.
This table compares the features of both editors. If a feature is planned for the new editor, you'll find our short- and long-term plan for it as well as any Confluence Cloud Support requests we are already tracking.
| Feature | Legacy editor | New editor | Will it be available in the new editor? | Track the backlog |
|---|---|---|---|---|
| Alignment |  | | AVAILABLE | |
| Alt text | |
| AVAILABLE | |
| Anchor macro | |
| AVAILABLE | |
| Background color of text |  | | GATHERING INTEREST | CONFCLOUD-64708 - Getting issue details... STATUS |
| Breadcrumbs | | | AVAILABLE | |
| Bullets | | | AVAILABLE | |
| Collaborative editing | | | AVAILABLE | |
| Companion app * |
edit files directly on the current page or edit files by going to list of page attachments |
edit files by going to the list of page attachments page | AVAILABLE | |
| Copy and paste layouts / drag and drop layouts | | | AVAILABLE | |
| Decisions | | | NEW EDITOR IMPROVEMENT | CONFCLOUD-62245 - Getting issue details... STATUS |
| Decision report macro | | | NEW EDITOR IMPROVEMENT | Learn more |
| Drag and drop reordering of table rows and columns | | | SHORT-TERM BACKLOG | CONFCLOUD-25847 - Getting issue details... STATUS |
| Drag and drop macros, text, and other content | | | NEW EDITOR IMPROVEMENT | CONFCLOUD-58945 - Getting issue details... STATUS |
| Embed JIRA links as smart card with bi-directional editing | | | NEW EDITOR FEATURE | |
| Emojis |
20 emoticons |
hundreds of emojis | AVAILABLE | |
| Find and replace | | | AVAILABLE | |
| Full-width pages | | | AVAILABLE | |
| Headings | | | AVAILABLE | |
| Image borders | | | SHORT-TERM BACKLOG | |
| Image captions | | | AVAILABLE | |
| Image effects | | | GATHERING INTEREST |
CONFCLOUD-68220
-
Getting issue details...
STATUS
|
| Image annotations | | | SHORT-TERM BACKLOG | CONFCLOUD-67122 - Getting issue details... STATUS |
| Image sizing |
pixels |
grid | AVAILABLE | CONFCLOUD-67554 - Getting issue details... STATUS |
| Image is a link | |
| AVAILABLE | |
| Indentation | | | AVAILABLE | |
| Indented task / actions | | | AVAILABLE | |
| Inline comments on images | | | GATHERING INTEREST | CONFCLOUD-67745 - Getting issue details... STATUS |
| Inline comments when editing | | | NEW EDITOR IMPROVEMENT | |
| Insert markdown |
|
supports all commands except ||table|| converts when pasted | AVAILABLE | |
| Insert wikimarkup |
insert menu | | GATHERING INTEREST | CONFCLOUD-65756 - Getting issue details... STATUS |
| Invite to edit | | | AVAILABLE | |
| Labels | | | AVAILABLE | |
| Layouts | | | AVAILABLE | |
| Link search | |
only supports recents | LONG-TERM BACKLOG | CONFCLOUD-65363 - Getting issue details... STATUS |
| Link to attachments | | | SHORT-TERM BACKLOG Review this table for an alternate method | CONFCLOUD-65302 - Getting issue details... STATUS |
| Link to headings in tables, expand elements, layouts, and info panels | | | SHORT-TERM BACKLOG | CONFCLOUD-69198 - Getting issue details... STATUS |
| Link to stand-alone headings | |
copy link when viewing page | AVAILABLE | |
| Link to placeholder (undefined page) | | | AVAILABLE | |
| Link text to URL | | | AVAILABLE | |
| Lists (quickly changing between numbered, bulleted, and action item) | |
can switch from bulleted to numbered and vice versa | GATHERING INTEREST | CONFCLOUD-67488 - Getting issue details... STATUS |
| Live macros (full preview in edit mode) | | | NEW EDITOR IMPROVEMENT | |
| Macro keyboard shortcut |
use open curly bracket, exclamation point, and open square bracket |
use slash for everything | NEW EDITOR IMPROVEMENT | |
| Media keyboard shortcut | | | NO PLAN slash command is used for all | |
| Media picker | | | AVAILABLE | |
| Media from other pages | | | GATHERING INTEREST | CONFCLOUD-65344 - Getting issue details... STATUS |
| Mentions | | | AVAILABLE | |
| Multiple authors | | | AVAILABLE | |
| Nested bodied macros |
| | GATHERING INTEREST | CONFCLOUD-68323 - Getting issue details... STATUS |
| Nested expand inside tables | | | AVAILABLE | |
| Nested tables | | | GATHERING INTEREST | CONFCLOUD-58656 - Getting issue details... STATUS |
| Notify watchers | | | AVAILABLE | |
| Preview | | | AVAILABLE | |
| Publish button | | | AVAILABLE | |
| Restrictions | | | AVAILABLE | |
| Set location | | | AVAILABLE | |
| Share | | | AVAILABLE | |
| Smart links | | | AVAILABLE | |
| Sort tables edit | | | LONG-TERM BACKLOG | CONFCLOUD-29816 - Getting issue details... STATUS |
| Sort tables view | | | AVAILABLE | |
| Star | | | AVAILABLE | |
| Sticky headers | | | NEW EDITOR IMPROVEMENT | |
| Styling | | | AVAILABLE | |
| Symbols | | | GATHERING INTEREST symbols natively available through your OS are more comprehensive | CONFCLOUD-67811 - Getting issue details... STATUS |
| Table cell background color |
49 colors |
21 colors | GATHERING INTEREST | CONFCLOUD-70227 - Getting issue details... STATUS |
| Table types / toolbar |
responsive and fixed-width |
fixed-width, wide, and full-width | AVAILABLE | |
| Table / toolbar options |
page toolbar |
floating toolbar | LONG-TERM BACKLOG | CONFCLOUD-67594 - Getting issue details... STATUS |
| Table widths / custom | | | GATHERING INTEREST | CONFCLOUD-67748 - Getting issue details... STATUS |
| Tasks | |
renamed to Action Lists | AVAILABLE | |
| Text color |
40 colors |
21 colors | SHORT-TERM BACKLOG | CONFCLOUD-67183 - Getting issue details... STATUS |
| Watch | | | AVAILABLE | |
| Web linked images | | | GATHERING INTEREST | CONFCLOUD-65749 - Getting issue details... STATUS |
| What did you change comment box | | | AVAILABLE | |
| Width options for elements (fixed-width, wide, and full-width) | | | NEW EDITOR IMPROVEMENT | |
| Wikimarkup autoformatting | | | GATHERING INTEREST | CONFCLOUD-5309 - Getting issue details... STATUS |
*The Companion app will be removed from Confluence at the end of March 2022. You won’t be able to edit files using the app after that date.
To find out more about macros that were removed and replaced along with alternate methods for accomplishing certain tasks, check this page.