Release Notes for XWiki 8.2 Milestone 2

Version 31.1 by Alex Cotiugă on 2016/06/30
Warning: For security reasons, the document is displayed in restricted mode as it is not the current version. There may be differences and errors due to this.

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.

This milestone release features a redesigned default homepage, a new application index in the drawer and minor improvements to the template providers, the Flamingo skin and Ratings. For developers, we have some welcomed Livetable macro improvements and a long overdue change of behaviour for the getRenderedContent method.

New and Noteworthy (since XWiki 8.2 Milestone 1)

Full list of issues fixed and Dashboard for 8.2.

New Homepage

We replaced the Dashboard application from the main Homepage and added introductory steps as wiki syntax. This change will make it simpler for new users to edit the Homepage content, while also benefiting from some basic help concepts. The left panels area also showcases now the 'Navigation' panel, while the right panels area contain a 'Need Help?' panel.

Tour for Homepage

A tour has been created to present the UI elements existing on the Main.WebHome page. Every user will be guided through this tour in order to become familiar with XWiki.

The [gallery] macro is a standalone macro and it cannot be used inline. Click on this message for details.

Application Index

We removed some applications from the AppBar (like Scheduler, Invitation, Panels, etc.) with the intention to simplify the interface and promote a smaller number of applications inside the AppBar panel. In order for the applications to still be discoverable, we added in the Drawer an Application Index.


Template Icons

When creating a new page, the Template Providers for specific applications can now add an icon and a description. We added new icons and descriptions for the Blog and Dashboard default templates. 



  • Improved the edit section styling to be in consistency with the Flamingo Skin style


  • Improved the way ratings stars are displayed by removing the white background from picture


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


The following dependencies have been upgraded:

For Developers



The following translations have been updated: 

Tested Browsers & Databases

The QA Tests are executed after the release has been done. Thus, they are being prepared now and will be published soon.

Known issues

Backward Compatibility and Migration Notes

General Notes

When upgrading make sure you compare your xwiki.cfg, and web.xml files with the newest version since some configuration parameters may have been modified or 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 XWiki 8.2 Milestone 2


The behavior of the getRenderedContent methods located in Document/XWikiDocument changed a bit.

  • methods taking a String to render in the context of the document: they are still rendering in the context of the document but with the right of whatever called the method
  • methods rendering the document itself: they are still rendering in the context of whatever called this method but with the right of the document

API Breakages

The following APIs were modified in XWiki 8.2 Milestone 2:

  • No actual breakage. Class was moved to another module
    • Violation type:
    • Code:
      ## Old:
      class org.xwiki.rendering.parser.ContentParser

Get Connected