This is the release notes for XWiki Commons, XWiki Rendering, XWiki Platform and XWiki Enterprise. They share the same release notes as they are released together and have the same version.

<insert description of release here>

New and Noteworthy (since XWiki 5.2 Milestone 2)

Full list of issues fixed and Dashboard for <version>.

<feature N>

<description of feature N>

Export big wikis as XAR

It's possible to enable the use of new WikiStream framework in standard export action (use in the standard export UI for example). Among other things it allows exporting a wiki of pretty much any size.

WikiStream is too young for it to be enabled by default and will require heavy testing. In the meantime you can try it by uncommenting # xwiki.action.export.xar.usewikistream=1 at the end of xwiki.cfg file.

Markdown Syntax 1.1

We've added version 1.1 of the Rendering Syntax for Markdown, adding support for:

  • Macros
  • Superscript and subscript
  • (X)HTML improvements

Top Menus changes when there is more than one wiki

We have removed the XWiki right menu and created a "Home" menu instead.


  • Improved Active Installs Server side API to be able to pass any query to count installs.
  • Active Installs Client now also send the Distribution id in addition to the Distribution version to identify the "product" sending the ping
  • The checkboxes for the global rights settings are now displayed on the left of their labels.


  • The live search (search suggest) now displays a message when there are no results.


See the full list of JIRA issues fixed in this release.

For Developers

<developer feature N>

<description of developer feature N>

WikiStream improvements

Various improvements and bugfixes to fully support the use case of exporting a entire wiki into a XAR package.

Deprecated and Retired projects

<description of deprecated and retired projects>


The following dependencies have been upgraded:

  • Xerces2-Java 2.11.0


  • Added DocumentReference and EntityReference property converters which makes possible to:
    • use them in rendering macros parameters beans (see How to write a macro)
    • in Velocity pass a String directly to a method requiring a DocumentReference or EntityReference
  • Added new API to the JODA Time plugin to get an ISO8601 formatter.


The following translations have been updated: 

Tested Browsers & Databases

Known issues

Backward Compatibility and Migration Notes

General Notes

You may also want to import the default wiki XAR in order to benefit from all the improvements listed above.

Always make sure you compare your xwiki.cfg and files with the newest version since some configuration parameters were added. Note that you should add so that XWiki will attempt to automatically migrate your current database to the new schema. Make sure you backup your Database before doing anything.

Issues specific to XWiki <version>

<issues specific to the project>

API Breakages

The following APIs were modified since <project> <version - 1>:

<clirr output here>

Get Connected