Release Notes for XWiki 8.2 Milestone 2

Last modified by Thomas Mortagne on 2017/03/24

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.

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


  • Added 2 new column types for the Livetable macro: "boolean" and "multilist"



  • It's now possible to access SSL services which are using a Let's Encrypt certificate even when the JVM used to run XWiki does not embed it (that would be JVMs < 1.8.0_101)


The following translations have been updated: 

Tested Browsers & Databases

Here is the list of browsers we support and how they have been tested for this release:

BrowserTest Result
Chrome30.pngGoogle ChromeNot Tested
Firefox30.pngMozilla FirefoxNot Tested
IE30.pngInternet Explorer 10Not Tested
IE30.pngInternet Explorer 11Jira Tickets Marked as Fixed in the Release Notes + New and Noteworthy Features

Here is the list of databases we support and how they have been tested for this release:

DatabaseTest Result
hypersql.pngHyperSQLNot Tested
mysql.pngMySQLNot Tested
oracle.pngOracle 11.2Jira Tickets Marked as Fixed in the Release Notes + New and Noteworthy Features
postgresql.pngPostgreSQLNot Tested

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