Confluence 4.0-m27 EAP Release Notes


On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

3 June 2011With great pleasure, Atlassian presents our first public milestone of Confluence 4.0.
An Early Access Preview (EAP) release is a snapshot of our work in progress, primarily focused on allowing Confluence users to see the new features in advance and provide us with some useful feedback. It also gives plugin developers an opportunity to test and fix their plugins in advance of an official release.

Highlights of Confluence 4.0 EAP:



Downloading the Confluence 4.0 EAP

The Confluence 4.0-m27 EAP Release is available here. When upgrading, please follow the upgrade notes below.

Unable to render {include} The included page could not be found.

Highlights of Confluence 4.0


Simplified Editing Experience

We've rebuilt the Confluence editor from the ground up, to bring you an editing experience that's simpler, faster and more intuitive.


  • Just one editor!
  • Left, Centre, Right align, without any macros.
  • Indent paragraph blocks and lists from the toolbar.
  • New Color Picker.
  • The user interface has been streamlined.


Introducing Macro Placeholders and New Macros

Confluence 4.0 introduces macro placeholders, a visual representation of your macros while editing. Create rich content with existing and new macros, but without them getting in the way.

Easy Macro Management

To make macros easier to manage when editing, the editor now uses macro placeholders. Placeholders offer the following advantages:

  • Quick access to macro editing
    Edit the content of a macro directly in the editor, or double-click the placeholder to open the Macro Browser for parameter editing.
  • Macro placeholder properties panel
    Every macro placeholder has a properties panel. The properties panels for particular macros, such as the Status and View File macros, have additional functionality, as described below.

New and Improved Macros

We've bundled more macros with Confluence, and made some of the existing macros better, to help you easily include and present relevant content:

  • New: Status Macro
    The Status macro displays a colored lozenge in the editor, so you can see the status directly. You can use the properties panel to change the status while editing, without having to use the Macro Browser.
  • New: Expand Macro
    The Expand macro allows you to add a dynamically expandable section of text to your page.
  • Improved: Include Page Macro
    The properties panel for the Include Page macro has a 'Go to included page' button that allows you to quickly check the page you have included, while still in the editor.
  • Improved: JIRA Issues Macro
    You can quickly open up the JIRA issue or filter, right from the editor, using the new 'View in JIRA' button in the properties panel.
  • Improved: View File Macro
    The placeholder for the View File macro displays an image according to the file type (for example PDF or Word file). And you can easily download the file while you are editing the page, using the new 'Download file' button in the properties panel.


Autoformatting – Write Wiki Markup In the Editor

Many of Confluence's biggest fans are avid wiki markup users. For you aficionados, we wanted to give you the fastest editing experience possible, while preserving the speed and efficiency of your existing wiki markup skills. So, we present you with Autoformatting!

Autoformatting lets you type wiki markup into the editor and "auto-formats" your text on the fly. To learn more, click on the "?" help button in the editor and select the "Wiki Markup" tab.

Try these and see what you think:

  • Font Formatting
    Bold, underline, strikethough, italic, superscript, subscript – just type the markup, such as *Bold*, and watch it convert to Bold on the fly!
  • Basic Tables
    Try typing |||||| , or || Heading 1 || Heading 2 || , then hit enter to get a table header like this:

    Heading 1

    Heading 2

  • Emoticons
    All of our emoticons convert on the fly. Try typing (/) in the editor to instantly see this: (tick) .
  • Lists
    For numbered lists, type # and a space at the start of each line.
    For bulleted lists, type * and a space at the start of each line.
  • Headings
    Type h4. then some heading text to see a level 4 heading.


New Wiki Markup Dialog

Many people tell us they like to take notes in wiki markup, then paste them into Confluence. We've also spoken to customers who have lots of scripts that produce wiki markup and are manually inserted into pages. For these folks, we present the Wiki Markup dialog. Simply select 'Wiki Markup' from the 'Insert' menu to launch the Wiki Markup dialog. From there you can insert any wiki markup, even macros.


Autocomplete Improvements

Autocomplete uses wiki markup syntax to quickly link to content, embed images and other media and insert macros into the page. If you haven't experienced autocomplete, you should see this blog post. Be sure to try the following:

Quickly insert a link to create a page with Autocomplete for links. Simply type '[' in the editor and as you type, Confluence will display a Create Page link if a page with that title does not already exist in your current space.

Instant Link, Media and Macro Creation

Type [, ! or { in the editor to add various kinds of content to your page:

  • The first item in the list is pre-selected to make editing even faster.
  • The macro autocomplete list now loads much faster.
  • The macro autocomplete list now inserts most macros directly, without launching the Macro Browser, unless the macro requires a parameter.


Introducing Confluence Mentions

Confluence 4.0 includes the new Mentions feature. This allows you to easily bring in collaborators to a conversation: if you are mentioned in any Confluence content (a page, blog, comment or status update), you will be notified by email.

To mention someone, type @ and their name, when editing. Mentions will first suggest people you are following in your network, so you can quickly find and involve your friends.


Improved Table Operations

We've made table operations better in Confluence 4.0 with the following features:

New In-Context Table Toolbar

The new table toolbar removes the need for a context menu and only appears when you add a table to the page.

New Table Operations

New table manipulation buttons are available for highlighting discrete cells, rows or columns and for copying or pasting rows.

Merge and Split Table Cells

You can now merge and split cells in a table. This feature satisfies the single most popular issue on our issue tracker!


Improved Page Comparison Functionality

We've got a better way to view changed content in Confluence.

Improved Page Diffs

We've simplified page diffs to make them easier to read. Additionally, page diffs now show changes to both formatting and macros.

Diffs in Email

Where possible, email notifications now show page differences as they appear in Confluence. These come through with the diff color coding.


New Email Design

All email notifications in Confluence now have a new design. This works in major email clients as well as on the iPhone.


New Editor Plugin Points for Developers

We've added more editor plugin points for developers. Notable improvements include:

Extend the Macro Property Panel

Plugin developers can add buttons to the Macro Property Panel in the editor.
For example, insert a Gliffy diagram.

Render an Image in the Macro Placeholder

A plugin developer can render an image instead of a placeholder for bodyless macros. Here is an example, showing a Gliffy image rendered inside the editor:

Custom Parameter Rendering in Placeholders

You can choose to display any parameter in the macro placeholder in the editor, instead of having the placeholder automatically show the first few parameters.

New Pluggable Format Menu

Plugin developers can add items to the editor's Format menu.


Other Improvements

As always, we have made various small improvements to Confluence screens and functionality.

  • Administrator's task list in the Admin Console
    This new task list in the Admin Console helps administrators get started after a new install.
  • New keyboard shortcuts:
    • CMD+S to save a page from the change comment field.
    • CMD+SHIFT+e to preview when you are in the editor; hit 'e' to get back to the editor.
    • CMD+SHIFT+d to display the Wiki Markup dialog.
  • Better Image Handling
    In the Insert Image dialog, we've introduced the Search tab so you can insert images from other pages. And all images now embed as clickable thumbnails.
  • Option to disable the "secure" cookie
    When using HTTPS, you can disable the "secure" cookie, just for the login page.
  • Help tips in the administration screens
    The help tips have been moved into the field descriptions.
  • Backup and Restore page
    The Backup and Restore page has been redesigned.
  • 404 page
    The 404 page now has a dashboard breadcrumb.


Infrastructure Changes

This release includes a number of improvements in the APIs and under the covers as well.

  • Support for Chrome
    We now offer support for Chrome in Confluence 4.0. See the upgrade notes for more information about browser support.
  • API Changes
    We have disabled the getPage() and getBlogEntry() read methods in the XML-RPC/SOAP API. If you have a script that primarily reads or appends to existing pages, it will break. Creating pages and overwriting existing pages will still work.
  • Upgrade to AUI 3.4
    Confluence 4.0 uses AUI 3.4.
  • Anti-XSS Mode
    Anti-XXS mode is now enabled by default for plugins.
  • Mail Page Plugin
    The Mail Page plugin is no longer bundled in Confluence.
  • Alignment and Border Parameters
    The alignment and border properties in the macro definition template have been removed.


Helping You Transition to Confluence 4.0

We've created a set of resources to help you manage the transition away from wiki markup. We know your people have become experts with using wiki markup in Confluence, but we think you'll really appreciate the new editor, and we want to make it as easy as possible for you to make the change. The change management resources are listed under the current documentation.


We Welcome Your Feedback

To make it easy for you to provide EAP feedback we've created a simple "Got Feedback" button in the Confluence navigation bar:
Let the Confluence team know what you think of the EAP by providing feedback!

Upgrade Notes

  • Upgrading from a previous version of Confluence. Follow the normal upgrade instructions to upgrade your test instance to this release. We strongly recommend that you back up your Confluence Home directory and your database before upgrading.
  • When upgrading from a previous version of Confluence, if you have customized your cache settings (as documented in Cache Performance Tuning) then you may run into memory problems during the wiki to XHTML migration. We are working to fix this in a later milestone release but in the meantime you can revert your ehcache.xml to the default version.
    • If you still experience problems you should try reducing the 'maxElementsInMemory' attribute on each cache to a very small value such as 50.
    • Note that any cache changes you make to work around migration problems should only be considered temporary. You should restore caching to it's original settings again after migration has been successful.
  • Note that the 'Edit Page in Word' functionality of Confluence is being removed in Confluence 4.0.

A big thank you to everyone who helps us ensure that Confluence keeps getting better and better.

Last modified on Aug 12, 2016

Was this helpful?

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