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.
- Find out why we're making these changes.
- Check out the new features, and learn how to use them.
- See which features are temporarily unavailable, and what workarounds you can use.
- Tell us how you're finding this experience, ask a question, or report a bug.
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
- Text alignment options
- Some keyboard shortcuts
See below for more information and workarounds.
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).
Cleaner toolbars and in-context menus | Fixed width layouts with wide or full-width tables, images, and macros | Readability improvements | Live macros | Code formatting | Quick insert | Decisions | 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.
Click on an image to see the in-context toolbar appear. From here you can select alignment and layout.
Explicit image resizing, which lets you set the pixel size of an image, is temporarily unavailable - but will be back soon.
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.
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:
- Select the image, table, or macro to bring up the in-context menu.
- Choose the wide or full-width options.
Other page layouts, including multi-column layouts, are temporarily unavailable but will be back soon.
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.
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:
To add a code block, choosefrom 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.
⌘ + ]
Ctrl + ]
⌘ + [
Ctrl - [
Keep indent level
Writing inline code? Style it by surrounding it with two single back ticks, like so: `color: blue`
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.
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:
- Type <> to create a decision.
- Record what you've decided, such as "Team standup time is now at 10am."
- @mention other teammates who you want to keep informed, and they'll receive a notification.
Decisions can also be found under thein 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, choosefrom your toolbar and use an emoji instead. 🎉
We've also added custom emoji uploads - because every organization has their in-jokes, and that's important too. To add a custom emoji, choosefrom your toolbar > Add your own emoji.
- 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.
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.
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.