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?

Please note the following

  • Development releases are not safe. Development releases are snapshots of the ongoing Confluence development process. For that reason:
    • While we try to keep these releases stable, they have not undergone the same degree of testing as a full release.
    • Features in development releases may be 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 the eventual final release. Thus, it is possible that you will 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:

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.



Improvements in 3.4-m2 (5 issues)

Bug Fixes


Bugs Fixed in 3.4-m2 (8 issues)

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