Confluence Editing Improvements

We announced at Atlassian Summit that we're working on a range of changes to improve your editing experience. As these changes roll out, we'll be using this page to update you about new features, and to address any common questions.

Why are we making these changes? 

Creating content is at the heart of how you use Confluence, whether it's taking notes in a meeting, creating a dashboard to help track a project, reviewing and providing feedback on a script, or brainstorming on a new design.

We want to make this experience better, so we're focusing on some of the biggest user feedback issues we've received. The latest updates section covers new and updated features in detail, but the goal of all of these changes is to give you:

  • A cleaner interface with fewer distractions

  • Features that are easier to find and use

  • Better looking content

  • Improved stability, reliability, and speed

We're building this to work across the entire Atlassian suite, so you'll have the same experience whether you're editing content on Confluence, Jira, Bitbucket, or any other Atlassian products. 

We're making these changes incrementally, and just like when you're renovating a house, you might temporarily lose the use of a room feature as we repaint rewrite it. Features currently under renovation include:

  • Meeting notes blueprint customization
  • Find and replace
  • Change messages when publishing
  • Notify watchers toggle
  • Inline macro browser
  • Explicit image sizing
  • Indentation
  • Layouts
  • Text alignment options
  • Anchors
  • Some keyboard shortcuts

See below for more information and workarounds.

Latest updates 

These changes roll out over the course of a few weeks:

: A very small percentage of you who don't use the currently unsupported features will see this roll out to all your pages, new and old.

If any older pages do contain unsupported content, they'll open up in the old editor and you'll be able to edit and publish them as per usual. 

 : Updates start rolling out to new meeting notes (doesn't affect existing ones). 

 : Updates start rolling out to new blog posts (doesn't affect existing ones). 

Jump to:

Cleaner toolbars and in-context menus | Fixed width layouts with wide or full-width tables, images, and macros | Readability improvements | Live macrosCode formatting | Quick insertDecisions | Unicode emojis and custom emoji uploads | Other changes

Cleaner toolbars, and in-context table and image menus 

We've cleaned up the Confluence toolbars so there's fewer visual distractions on your screen as you work.

Obsolete macros (like the strikethrough macro) have been removed, publishing options have been consolidated into the top toolbar, and image and table options have been moved into in-context menus so you won't see them until you need them. 

Image options

Click on an image to see the in-context toolbar appear. From here you can select alignment and layout. 

images getting resized using the in-context menu

(info) Explicit image resizing, which lets you set the pixel size of an image, is temporarily unavailable - but will be back soon.

Table options

Click on a table to see the in-context toolbar appear. From here you can add a header row or column and change the table width. Select the table outline to add or remove columns and rows, or select table cells to change background color and merge or split cells. 

table getting formatted and changed

Fixed-width layouts, with wide and full-width options for images, tables, and macros 

Fixed-width layouts let your pages look the same regardless of the size of the screen they're being viewed on, giving you control over the alignment and positioning of all your content. That means that you can create a page that looks just as good when viewed on a mobile device as on desktop. 

For images, tables, and macros that display better at larger sizes, choose a wide or full-width setting, and these will scale up or down according to screen size. 

To do this:

  1. Select the image, table, or macro to bring up the in-context menu.
  2. Choose the wide or full-width options.

width buttons at the bottom of a macro

(info) Other page layouts, including multi-column layouts, are temporarily unavailable but will be back soon. 

Readability improvements 

We've made a range of smaller improvements to make it easier for you to scan and read through pages.

  • Fixed-width layouts have been set at a line length that optimizes for readability.
  • We've chosen fonts for optical precision, ensuring they support improved legibility at smaller sizes, have wider tracking, and larger negative spaces.
  • We've increased line heights as per accessibility guidelines so it's easier to track a line of text. 

Live macros 

Macros let you add a range of advanced functionality to your page, from roadmaps and status markers to automatically updating tables of content and user profiles.

But until now, macros would display as grey boxes when you were editing a page, so you couldn't see what information they contained, or know what they would look like, until your page was published. 

We've replaced those grey boxes with live macros. These are full fidelity previews of what your macros will look like. That means that they look the same when published as they do while you're editing, and you'll be able to see all the information they contain.

So what used to look like this:


Now looks like this:

Code formatting 

To add a code block, choose  from the toolbar > code block or do it in markdown by typing ``` when you're editing a page. 

You'll notice that code blocks now have line numbers, indentation support, and bracket autocompletion - so you can type your code directly into Confluence, format it neatly, and keep track of each line. 

demo of code formatting

Indentation shortcuts

Action Mac Windows

Indent text

+ ]

Ctrl + ] 

Unindent text

+ [


Indent selection



Keep indent level



(info) Writing inline code? Style it by surrounding it with two single back ticks, like so: `color: blue`

Quick insert 

We've consolidated a bunch of Confluence autocomplete shortcuts, so that instead of remembering different keyboard combinations, you can now just type / to open the quick insert menu and insert macros, files, and images as you type. 

type forward slash while editing to open the menu


We're constantly making important decisions about how things should be done, or what our team is going to work on. Capture those decisions as they're made by creating them on a Confluence page:

  1. Type <> to create a decision.
  2. Record what you've decided, such as "Team standup time is now at 10am."
  3. @mention other teammates who you want to keep informed, and they'll receive a notification. 

shows two decisions, with stakeholders mentioned

(info) Decisions can also be found under the more actions menu in the toolbar.

Full suite of unicode emojis! (And custom emoji uploads) 

Emojis are important. So important, in fact, that we'd conducted a survey on them to learn more about their impact:

  • 56% of people agree that using emojis improves communication in the workplace.
  • 62% of people reported feeling closer to their coworkers through using emojis in their chats and conversations

Which is why we've added the full suite of unicode emojis to Confluence. Now, when words just aren't enough, choose smiley face from your toolbar and use an emoji instead. 🎉

click the smiley face in the toolbar and the emoji picker opens

We've also added custom emoji uploads - because every organization has their in-jokes, and that's important too. To add a custom emoji, choose  from your toolbar > Add your own emoji(awthanks) 

Other changes 

  • Markdown: Is fully supported, so you can either type or paste in markdown, and it will get automatically converted.
  • Actions: Are the new name for tasks. These work exactly the same as tasks have in the past, but have had a facelift to make them more visually distinctive. Actions assigned to you will show up in your profile, under your task list
  • Meeting notes: Have been updated with these new features. Check out our page on Meeting Notes to learn how to best use them. 
  • Links: The link modal has been replaced with an in-line link field. Select the text you want to link, click the icon from the toolbar, and paste in the URL you want to link to. 
  • Dates: The date picker now lives in the Quick Insert menu, so can be accessed by typing /date. Alternatively, type // and then press Enter.

Temporarily missing features and workarounds 

Some features will be temporarily unavailable as we rewrite them to be faster and more stable:

  • Meeting notes blueprint customization: Disabled while the template editor gets updated to match the new templates. As a temporary workaround, you can create your own template
  • Find and replace: Use your browser's Find function (CTRL + F on Windows or CMD + F on Mac) or use a Find and Replace browser extension. 
  • Change messages when publishing: No current workaround.
  • Notify watchers toggle: We're temporarily changing this functionality. Instead of a toggle, there's a Publish without notifying watchers option in the ellipsis menu next to the Close button. This is not persistent, so you will have to use this button each time you publish.

    (info) Can't see this? This option only appears after you first publish your page. 
  • Inline macro browser: Has been replaced by Quick insert
  • Explicit image sizing: No current workaround.
  • Indentation: No current workaround.
  • Layouts: Temporarily unavailable with no current workaround. 
  • Text alignment options: Temporarily unavailable with no current workaround. 
  • Anchors: Temporarily unavailable. To get around this, add a table of contents macro to your page, as this automatically generates anchors for each page header. To find the link to those anchors, right click (or long press, if you're doing this on mobile) on any of the headers in the table of contents, and copy the link address. 
  • Shortcuts: Some keyboard shortcuts are temporarily missing. Check the currently available shortcuts by pressing Cmd + / (Mac) or CTRL + / (PC).



Tell us what you think

Send us your thoughts via the Feedback button, which appears on the bottom right of your Confluence page while you're editing.

shows the feedback button in the bottom right of the page

Include as much detail as possible to help us understand how these changes are affecting you. We read every customer comment, even when we can't respond to all of them. 

Report a bug

Something looking not quite right? Submit a support ticket and our engineer-detectives will investigate. 

Join the discussion

We're posting on Atlassian Community with each major release. Come join the discussion.

Last modified on Oct 12, 2018

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.