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 bugfix release addresses some important problems discovered in the 8.4 release, like the translations issue, but also brings a couple of improvements, specifically focused on the Active Installs application and the Blog UI.

New and Noteworthy (since XWiki 8.4)

Full list of issues fixed and Dashboard for 8.4.1.

For Users

Consistent Blog Icons

The icons used in the Blog Application are now displayed using the Icon Theme Application, hence they are now consistent with icons used everywhere else in XWiki.

For Admins

Active Installs displays Distribution Graph

The Active Install application now displays a graph showing what packagings users have used to install XWiki (Debian, WAR, HSQLDB/Jetty, etc). You can see it live on


  • Get all org.xwiki* distributions: The graphs now matches all org.xwiki* distributions (used to only match XWiki Enterprise). Before, we were filtering on the org.xwiki.platform:xwiki-platform-web distribution id but since we now send the packaging used in the distribution id property, we needed to find a way to list all distributions done by the XWiki open source project.

For Developers

No changes!


  • An InstanceId converter has been added so that it's now possible to convert from String to InstanceId and vice versa (useful for Velocity scripts needing to call an API that accepts an InstanceId object for example).

All Changes

  • New Feature Closed XWIKI-13887 Display graph showing the various distribution ids used
  • Improvement Closed XWIKI-13881 Automatically convert Instance Id passed as a String into an InstanceId object
  • Bug Closed XWIKI-13880 "Show details" on ldap Authenticator displayed a velocity error
  • Bug Closed XWIKI-13873 Impossible to translate a page
  • Improvement Closed XWIKI-13870 Send extension features in active install
  • Bug Closed XWIKI-13866 Can't install on Debian jessie 8.6 because of dbconfig-mysql dependency
  • Improvement Closed XWIKI-13864 Match all org.xwiki.* distributions by default
  • Improvement Closed XWIKI-13863 Add support for wildcard in distribution id configuration
  • Improvement Closed XWIKI-13818 Use the XWiki Icon Set in the Blog Application
  • Bug Closed XWIKI-13493 The parent-child relationship of a page is not updated during a move
  • Bug Closed XWIKI-12937 Impossible to copy a page if the user has no edit right at the wiki or space level
  • Bug Closed XCOMMONS-1117 List converter crashes with <?> generic argument
  • Bug Closed XCOMMONS-1116 List converter does not take into account generics when the input is already a List
  • Bug Closed XCOMMONS-1114 Velocity automatic parameter convertion skip generics
  • Bug Closed XCOMMONS-1112 Null Log arguments are not serialized


The following translations have been updated: 

  • French
  • Polish

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 Firefox 50Jira Tickets Marked as Fixed in the Release Notes + New and Noteworthy Features
IE30.pngInternet Explorer 10Tested
IE30.pngInternet Explorer 11Not Tested

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

DatabaseTest Result
mysql.pngMySQL 5.7Jira Tickets Marked as Fixed in the Release Notes + New and Noteworthy Features
oracle.pngOracleNot Tested
postgresql.pngPostgreSQLNot Tested

Performances tests compared to 7.4.5

This report is not ready yet.

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.

API Breakages

No API has been broken since XWiki 8.4!


The following people have contributed code to this release (sorted alphabetically):

Eduard Moraru
Guillaume Delhumeau
Marius Dumitru Florea
Pascal Bastien
Thomas Mortagne
Vincent Massol

Created by Guillaume Delhumeau on 2016/11/14

Get Connected