Confluence 5.8.1-RC1 Release Notes

22 May 2015

Atlassian presents Confluence 5.8.1 Release Candidate 1. This release is a snapshot of our work in progress, primarily focused on allowing Confluence users to see the new features in advance. Beta releases also give add-on developers an opportunity to test and fix their add-ons in advance of an official release.

Downloading Confluence

Development releases are not production ready. Development releases are snapshots of the ongoing Confluence development process. While we try to keep these releases stable, they have not undergone the same degree of testing as a full release, and could contain features that are incomplete or may change or be removed before the next full release.

No upgrade path. Because development releases represent work in progress, we cannot provide a supported upgrade path between development releases, or from any development release to a final release. You may not be able to migrate any data you store in a Confluence development release to a future Confluence release.

Atlassian does not provide support for development releases.

Highlights of this release

Supercharge macros with CQL

In Confluence 5.7 we launched CQL (Confluence Query Language) to provide a powerful content search REST API. In this release we've added the power of CQL to two of our most useful macros - Content by Label and Page Properties Report.

CQL allows you to build your own query, just by adding fields. It's super flexible, and will allow you to focus in on just the pages you want to display.  We hope to bring CQL to more macros in future and welcome your feedback.

Content by Label macro powered by CQL

The Content by Label macro is great for displaying a dynamic list of related pages. Now with CQL you have even more control over the pages to display. Only include pages in a particular page tree, or containing specific text in the title or page, or that have a specific combination of labels.

Here's a simple example, that returns pages with the label 'meeting-notes', in any space, that mention a particular person.

Page Properties Report macro powered by CQL

We know you've long wanted to be able to report on multiple labels, or only pages under a specific parent page. With CQL, now you can.

Here's an example, that will return only pages with the labels 'project' and 'current', in this space that are direct children of the page 'New projects FY 2015'.

As you can see the possibilities are almost endless (or at least our engineers say they are!).

Building your own macro?

Check out our code with the Page Properties Report and the Content By Label macro if you want to include some CQL-added-superowers to your macro! 

New presentation mode for files 

You can now switch to full screen presentation mode right from the file preview.

If the file has multiple pages, use the up and down icons (or the up and down keys on your keyboard) to navigate to the next page or slide in the file. It's perfect for presenting PowerPoint, and other files that have multiple pages.

Launch the previewer from the Attachments macro

You can now launch the file preview directly from the attachments macro. Expand the file listing and click the new Preview button. Want to launch or download the file in the old way? Click the file name link instead.

Recover files from the trash

When you delete a file that is attached to a page, we'll now send it to the trash. Space administrators can recover files from the trash, just the same way as they do for pages from the Space Settings > Content Tools > Trash tab. 

Big improvements for huge tables

Do you create tables with lots of rows? You can now add a numbering column, which automagically numbers the rows in your table. Great for those big tables of requirements or project tasks. See the numbering column in action in the Requirements blueprint.

As a bonus, we've also added cut, copy and paste buttons for columns. Yey.

If that's not enough, table header rows will also stick to the top when you're viewing a page, making those really long tables easier to read. 

  There's a few exceptions...

Table headers aren't sticky when your:

  • space is using the documentation theme.
  • table is inside a page layout, or inside another table.
  • table has no header row or there are cells in the top row that aren't marked as headers.
  • table has a header column, instead of a header row, and scrolls horizontally.
  • table contains another table that has its own header.

Plan your roadmaps by month or week 

You can now choose to display your roadmaps in weeks or months in the Roadmap Planner macro.

Changes to page restrictions

You no longer need to add someone as an editor and viewer in the restrictions dialog. We'll check if the person has edit permissions, and if they do, we'll let them see the page (it's a bit hard to edit a page you can't see, right?). Any child pages will also be visible, unless there are further view restrictions on the child pages.

This change applies to existing pages too, so anyone who previously couldn't see a page because they only had edit permission will now be able to see the page. 

The way permissions are inherited on pages hasn't changed:

  • If you restrict viewing to a person or group, they'll be able to see that page and all its child pages (unless there are further restrictions on the child pages)
  • If you restrict editing to a person or group, they'll be able to see and edit that page, plus see its child pages (just the same as if you applied separate edit and view restrictions).
  • Parent pages (higher up in the page hierarchy) can have their own view restrictions that may prevent people from viewing your page.

Inline comment improvements

We've made several improvements to inline comments in this release, including collapsing replies to an inline comment where there are a large number of replies. 

Notify watchers remembers your preference

The editor will now remember your last selection for the Notify watchers checkbox. Less clicks, more win. 

Location, Restrictions and Labels get a new location in the editor 

The Restrictions, Labels and Location button have moved from the bottom of the editor to the top near the breadcrumbs.

Data Center improvements

We've added the ability for a node to recover the index from an existing node when joining the cluster. This is useful when adding a brand new node, or if a node has been shut down for more than a few days (longer than the journal service is able to catch up).

Infrastructure changes

  • This release adds support for Java 8 bytecode. See Preparing for Confluence 5.8 for more information.
  • When you install Confluence for the first time you now have the option to also install Confluence Questions and Team Calendars automatically. This saves some extra steps if you've purchased a license bundle that includes a license for Questions and Team Calendars.
  • We've replaced the embedded HSQL database with an embedded H2 database for new trial installations.

End of support announcements

  • End of support for Java 7
    As previously announced, from this release onward we no longer support Java 7 (JRE and JDK 1.7)
  • End of support for Tomcat 7
    As previously announced, we only support the version of Tomcat that is bundled with Confluence.
  • Advance notice: End of support for Internet Explorer 9 
    Confluence 5.8.x will be the last release to support Internet Explorer 9 
  • Advance notice: End of support for Oracle 11.1 and 11.2
    Confluence 5.8.x will be the last release to support Oracle 11.1 and 11.2
  • Advance notice: End of support for Microsoft SQL 2008
    Confluence 5.8.x will be the last release to support Microsoft SQL 2008
  • Advance notice: Plan to unbundle the documentation theme
    Confluence 5.8 will be the last release to bundle the documentation theme. If you are already using the theme, you'll be unaffected by this change. We will make the theme available on marketplace also. As previously announced we still plan to merge the documentation theme with the default theme in a future Confluence release, and will provide more information closer to that time.

See End of Support Announcements for Confluence for more information.

Known issues

There's a known issue related to setting up Confluence using the embedded H2 database on Mac OSX. See CONF-37625 - Setup wizard fails when creating embedded H2 database on Mac OSX Resolved  for more information and a workaround.

For developers

For more information on changes that may affect plugins see Preparing for Confluence 5.8 in our developer documentation. 

Giving feedback

We'd love your feedback so please:

  • Feel free to comment on this page with your feedback, or
  • Send us your comments via the 'Got Feedback' option in the header of your EAP Confluence site.

Upgrade notes

Follow the usual upgrade instructions to upgrade your test site to this release.

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