Release Notes 3.4-m2 ("Milestone 2")

Milestone release advisory

For testing use only

Do not use this release to upgrade your production systems.

This release is a public development release ('milestone') leading up to the next Confluence major release. Development releases are a snapshot of our work in progress, allowing our customers and especially plugin developers to see what we're up to.

Who should upgrade?

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.

In supplying milestone releases, our aim is to provide plugin developers with an opportunity to see the latest changes in the code.

Each milestone release has passed all our automatic tests and has been used for one week on our official internal Confluence server. Most of the issues solved have been reviewed too, and all of our milestone releases even have been performance tested for a while.

However, since our milestones releases are timeboxed (that is, they are released every two weeks, no matter how far we have come implementing features and bugfixes) there is always a chance that we have new known bugs that are scheduled to be fixed in the next milestone, or completely new bugs unknown even to us.

Additionally, we have not completed our performance testing and compatibility testing for all supported databases and user management systems. So, for example, a milestone release may behave well on a small installation but show severe problems when subjected to many users.

Upgrade Procedure

Follow the normal upgrade instructions to upgrade your test instance to this release. We strongly recommend that you backup your Confluence home directory and database before upgrading!


All development releases are available from the development releases page on the Atlassian website.

Previous Milestone(s)

Previous milestones in the 3.4 release:

New Features

Universal Plugin Manager

Confluence is now bundled with Universal Plugin Manager (UPM). The UPM allows you to see and manage the plugins that you have installed in Confluence, and it allows you to discover, download and install new plugins from the Atlassian Plugin Exchange. You can read more about the UPM here.

User Macros in the Macro Browser

User macros are now available in the Macro Browser and can have the same amount of metadata as existing plugin macros. The current default is to hide user macros from browse/search in the Macro Browser until the admin updates them. Below is a screenshot of what the user macro form looks like (Note: This will slightly change in a later milestone)

Confluence administrators and user macro developers can enter macro and parameter meta-data via the admin console. This meta-data will reflected in the macro browser. Below is an example snippet of the new syntax that is available in a user macro:

## @param author:title=Author(s)|type=string|required=false|desc=Include pages created or modified by these authors. Separate each author with a comma.
## @param showLabels:title=Show Labels for Each Page|type=boolean|required=false|default=true
## @param showSpace:title=Show Space Name for Each Page|type=boolean|required=false|default=true
## @param excerpt:title=Display Excerpts|type=boolean|required=false|default=false|desc=Displays the first line of excerpts for each page.
## @param maxResults:title=Maximum number of results|type=int|required=false|default=15
## @param title:title=List Title|type=string|required=false
## @param spaces:title=Spaces|desc=These are case-sensitive. Separate each item with a comma or single space.|type=string|required=false
## @param sort:title=Sort By|type=enum|required=false|enumValues=title,creation,modified|default=modified
## .... (rest of the macro content)

More detailed User Macro API docs  will be provided later, explaining how to enable user macros in the macro browser and how to develop user macros for the macro browser.


Bug Fixes

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