Confluence 5.0 Release Notes

26 February 2013

Highlights of Confluence 5.0


Thank you for your feedback

(green star) Over 25 feature and improvement requests fulfilled
(green star) More than 875 votes satisfied

Video of what's new

A visual refresh

Confluence 5.0 introduces a modernised look and feel that is consistent with other Atlassian applications and follows the new Atlassian Design Guidelines.  

Updated global navigation

We have made a number of changes to the Confluence header, to improve usability and visual design. If you're using other Atlassian products, such as JIRA or Stash, you will also notice more cross-product consistency.

  • New application navigator. This appears on the left of the header if your Confluence site is linked to other applications. Using the application navigator, people can move easily from Confluence to JIRA and other linked Atlassian applications. Administrators can add more links too. For example, link to your internal HR systems, corporate applications, external web links, and so on.
  • Space directory and people directory immediately accessible. The new header includes options pointing directly to the space and people directories. Add-ons will also be able to add items to the header. For example, Team Calendars will add a 'Calendars' option.

  • Consolidated help menu. A new top-level help icon presents links to online help, keyboard shortcuts, and other useful pages.
  • Consolidated administrator menu. Site administrators can access add-on management, user management and general administrative settings, directly from the cog icon in the header.
  • Browse menu removed. The 'Browse' menu in earlier Confluence versions contained a mishmash of options, some relating to the current space, some to the entire site, and some random options like keyboard shortcuts. Now things are much tidier and will feel familiar to users of JIRA too:
    • Site-level items now appear on the left of the header: Dashboard, space directory and people directory.
    • Space-related items are now in the sidebar (see Sidebar below).

    Note that the 'Browse' menu remains available in the Documentation theme, which does not include the new sidebar.

Content creation made simple

Just choose 'Create' in the new header. You can create an empty page, a blog post, or a page based on a template. Confluence will even suggest the space where your new page will go, based on the spaces you have visited or created content in recently.

Rest assured, we've looked after power users too. Press 'C' on your keyboard to open the 'Create' dialog quickly. You can also navigate around the dialog using your keyboard.

Note: The 'Add' option no longer appears at top right of Confluence pages. It is replaced by the 'Create' option. To add a comment, scroll to the bottom of the page or press 'M' on your keyboard.

New sidebar for content discovery

Location, location, location! Confluence spaces now have a new sidebar, containing useful links and navigation aids. The sidebar helps people viewing a space answer these questions:

  • Where am I?
  • What is in this space?
  • What are the most important links that I should be aware of?

The sidebar appears on the left of every page in spaces that use the default Confluence theme.

Space navigation in one place

From the sidebar you can choose a content type (pages, blog) or go to a different part of the space. Contextual navigation options appear at the bottom of the sidebar, based on the type of content you are viewing. For pages, the navigation section displays the children of the current page. For a blog, the navigation section shows a history of blog posts.

Space administrators can access the redesigned 'Space tools' pages from the sidebar, as well as the option to configure the sidebar.

Customising your sidebar

Space administrators can configure what is displayed in the top section of the sidebar.

  • Configure your space logo and name. Customising the space details for your team or project has never been easier.
  • Show or hide pages and blog. Perhaps you don't need a blog in your space, or perhaps you are using only the blog? You can show or hide the links, so that people don't stray into a content desert.
  • Add space shortcuts. Help your team members and colleagues find important pages and other content, by adding shortcut links on the sidebar. This is a great way of encouraging collaboration and improving productivity.

Minimised sidebar

Collapse the sidebar to make best use of the space available. Click and drag the border, or use the keyboard shortcut: '[' . With the sidebar collapsed, you can still access the sidebar options.


Editor improvements

Instant-load editor

Increased speed means increased productivity. Confluence 5.0 instantly loads the editor when you choose 'Edit'. You don't have to wait for a full page refresh. Even faster: Type 'E' to start editing a page.

Responsive new design

With a new visual refresh, the responsive editor toolbar and footer maximise your editing space based on the size of your screen. This is useful for lower resolution devices such as projectors. When your browser window is reduced to a certain size, the buttons and spacing in the editor toolbar and footer will shrink – perfect when doing presentations or taking notes during a meeting.

New and improved macros

We have made improvements to some existing macros and introduced a new one:

  • WYSWYIG YouTube video macro placeholders. When you paste a link to a YouTube video, you will see a preview – right there in the editor.


  • New Content Report Table macro. This new macro makes it easy to generate a report like the Content by Label macro, but in tabular format. See Content Report Table Macro.
  • Including excerpts across spaces. The Excerpt Include macro can now include content from another space. When you type the name of the page into the Excerpt Include macro dialog, Confluence will offer a list of matching pages including those from other spaces. The wiki markup option is also available. You can type the space key followed by a colon and the page name, like this: MYSPACE:My page name.
  • Nested Expand macros. You can now include one Expand macro inside another.
  • Metadata Details and Details Summary macros renamed. The Metadata Details and Details Summary macros have been renamed to be more descriptive, and make it clearer that these two macros are used as a set. The functionality of the macros has not changed, and an upgrade task will automatically change the names over. The wiki markup and storage format names have not changed.

    Old Name New Name
    Metadata Details macro Page Properties macro
    Details Summary macro Page Properties Report macro


Quick access to recently viewed pages

Finding pages you have visited recently is now easier than ever. A new dialog displays a list of your recent pages that you can search through and navigate quickly. Open the dialog by clicking on the user menu then choose 'Recently Viewed', or use the keyboard shortcut 'g' then 'r'.


Redesigned space administration and space tools

Our design team has given some love to the space administration pages and other space tools, so they now have that special Confluence 5.0 magic too. When you visit the new 'Space tools' option, we automatically take you to the permissions screen, since this is the most-used space administration page.

Note: In spaces using the default theme, the 'Browse' menu is gone. It is replaced by the options in the new sidebar.

If you have an add-on that adds an option to the space administration screens, you should test your add-on against this release and adjust the location of the option if necessary.

Improved theming and branding

In the new Confluence header, you can customise the look and feel to fit your company branding by uploading your corporate logo. Details are in the documentation.

Automatic colour schemes

To make it easier to theme your Confluence site, upon uploading a new logo we automatically detect the primary colours use magic to configure the site colour scheme to match.

Improved user and group management for large sites

We have made a number of improvements to user and group management, which are especially useful on sites with a large number of users.

Improved LDAP performance

We have removed unnecessary data retrievals when synchronising LDAP directories, which gives a marked improvement in performance. See issues CWD-3034 and CONF-23943 .

Improved group administration UI

When browsing the list of groups, you can now search for group names containing a specific string, and adjust the number of groups displayed on a page. We have also improved the pagination when searching through groups. You can now choose whether to show 10, 20 or 50 results per page.


Improvements to the people directory

This release delivers three improvements to the people directory, with 180+ votes between them:

  • Exclude deactivated users from the people directory by default, and provide the option to include them if required (CONF-16477  , fixed in Confluence 4.3.3). Similarly, exclude externally-deleted users from the people directory by default. Details are in the documentation: Searching the People Directory.

  • Fix the bug that caused the people directory to appear empty or to show inconsistent results, after users have been deleted from LDAP or another external user management system (CONF-11467 , fixed in Confluence 4.3.3).

  • Make sure users from LDAP appear in the people directory and search results even when not logged in ( CONF-6404 , fixed in Confluence 4.3.2).

More goodness

Exporting blog posts to PDF

Need to share that company announcement as a PDF document? Just like pages, you can now export blog posts to PDF. Go to 'Tools' > 'Export to PDF'.

Deleting a version of a page

Want to delete a specific version of a page? Now you can. Go to 'Tools' > 'Page History' and choose the option to remove a particular version of the page. This improvement satisfies more than 250 votes!

In-page notifications about comments and edits

Let's say you are viewing a page, and someone adds a comment to that page, or updates the page. Wouldn't it be cool to know about the comment or the update immediately? Now you can! Confluence displays a popup notification near the bottom of the screen. Choose 'Show' to see the comments, or 'Ignore' to dismiss the notification.

Improved way to customise default space content – now via templates

Want to customise the home page of all new spaces created in Confluence? Administrators can now edit a template for the home pages of site spaces and personal spaces. The process is quick and easy, and does not impact your existing spaces.

Easier customisation of site welcome message

You can now use a template to configure the top left section of the dashboard (the 'site welcome message'). This gives you the full power of the rich text editor to create the welcome message.

Infrastructure changes

These are points of interest for plugin and add-on developers.

    • AUI upgrade. Confluence 5.0 includes the latest version of AUI 5.0.
    • UPM upgrade. Confluence 5.0 ships with version 2.8.1 of the Universal Plugin Manager. Note that you can upgrade your version of UPM at any time, via the add-on manager in your Confluence administration console.
    • AppLinks upgrade. Confluence 5.0 includes version 3.10.6 of   Application Links . Note that people with 'Confluence Administrator' permissions can now configure application links. Previously, you needed 'System Administrator' permissions to configure application links.
    • New and changed APIs.

The Confluence 5.0 team


Adrien Ragot
Agnes Ro
Alexander Dickson
Anatoli Kazatchkov
Ángel Eduardo García Hernández
Anna Katrina Dominguez
Chris Kiehl
Craig Petchell
Dave Loeng
David Richard
David Rizzuto
David Taylor
Don Willis
Edith Tom
Esther Asenjo Reyes
Fabian Kraemer
Ivan Loire
Jesper Särnesjö
Joe Xie
Jonathan Raoult
Julien Michel Hoarau
Kenny MacLeod
Matthew Erickson
Niraj Bhawnani
Olli Nevalainen
Paul Curren
Peggy Kuo
Richard Atkins
Ryan Ackley
Sam Tardif
Steve Haffenden
Steven Lancashire
Wesley Walser
William Archinal
Xavier Sanchez Taixe

Charles Miller

Plugin updates

David Chui
Kai Chong
Ong Kang Leng
Philip Cher


Product management
Bill Arconati
John Masson
Sherif Mansour

Product marketing management
Ryan Anderson
Terrence Caldwell
Matthew Hodges

Development manager
Matt Ryall


Sydney support
Michael Seager
Denise Unterwurzacher
David Mason
Lachlan Dally

Amsterdam support
Yilin Mo
John Inder
Alex Conde
Peter Koczan
Ruchi Tandon

Brazil support
Alyson Reis
Guilherme Heck
Rodrigo Adami
Tiago Comasseto
Luiz Carlos Junior
Guilherme Nedel
Bernardo Acevedo
William Zanchet

Kuala Lumpur support
Joachim Ooi
Husein Alatas
Septa Cahyadiputra
Foogie Sim
Hanis Suhailah
Rian Josua Masikome
Amalia Sanusi

San Francisco support
Adam Laskowski
Tim Wong
Robert Chang
Ryan Goodwin
Andrew Campbell
Daniel Borcherding

Service Enablement
Renan Battaglin

Cross-product team

Henry Tapia
Valter Fatia

Quality assistance  
Joey Corea
Mark Hrynczak
Glenn Martin

Technical writing  
Sarah Maddox
Rachel Robins

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport