Release Notes for XWiki 12.3-rc-1

Last modified by Ilie Andriuta on 2020/06/01

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

The version introduce the new in-place editor for wiki pages content title and some metadata as well as for standard AppWithiMinutes entries and will be added to more and more areas in future versions. For extensions developers many improvements has been added to dedicated Solr cores system.

New and Noteworthy (since XWiki 12.2)

Full list of issues fixed and Dashboard for 12.3.

For Users

Extended Page Information

The information tab displayed at the bottom of each page has been extended with more information such as the original page locale, the current page locale, the available page translations, the page syntax and whether the page is hidden or not. Moreover, some of the page information is now editable in-place, from view mode.

In-place edit for application entries

The entries of a newly-created AppWithinMinutes application are now editable in-place. For existing applications you will need to edit the application and go through the application wizard so that the application sheet is re-generated, but be aware that you might loose you customizations in the process.

In-place edit for plain wiki pages

You can now edit plain wiki pages in-place, if the WYSIWYG editor is the preferred content editor.

For Admins

  • On MySQL, the character set utf8mb4 is now set on the main database for new instances installed via our debian packages.

For Developers

Solr multi-core improvements

Solr core are now created at runtime (for embedded Solr setup) so it's not needed to restart after installing an extension which require a custom Solr core.

This version introduces which provide a lot of helpers for creating/migrating Solr cores. See more details on Solr Search Application.


  • Support targeting groups in Notifications: Using a TargetableEvent in the Notification API now allows to target also Groups and not only Users anymore.

  • VFS content type: It's now possible to explicitly indicate the Content-Type to return with the HTTP response containing the file. See VFS API for more details.


The following runtime dependencies have been upgraded (they have a different release cycle than XWiki Commons, XWiki Rendering and XWiki Platform):


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:

 BrowserTests performed and results
Chrome30.pngGoogle Chrome 81Not Tested
Firefox30.pngMozilla Firefox 75Jira Tickets Marked as Fixed in the Release Notes

Tests run and results
Edge30.pngMicrosoft Edge 81
IE30.pngInternet Explorer 11
Safari30.pngSafari 13Not Tested

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

 DatabaseTests performed and results
hypersql.pngHyperSQL 2.5.0Not Tested
mysql.pngMySQL 5.7Jira Tickets Marked as Fixed in the Release Notes

Tests run and results
oracle.pngOracle 19c
postgresql.pngPostgreSQL 12Not Tested

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

 Servlet ContainerTests performed and results
tomcat-icon.pngTomcat 9.0.31Jira Tickets Marked as Fixed in the Release Notes

Tests run and results
jetty-icon.pngJetty 9.4.27 (XWiki Standalone packaging)
jetty-icon.pngJetty 9.4.27Not Tested

Known issues

Backward Compatibility and Migration Notes

General Notes

  • When upgrading make sure you compare and merge the following XWiki configuration files since some parameters may have been modified, removed or added:
    • xwiki.cfg
    • web.xml
    • hibernate.cfg.xml
  • Add in xwiki.cfg so that XWiki will attempt to automatically migrate your current database to any new schema. Make sure you backup your Database before doing anything.

API Breakages

The following APIs were modified since XWiki 12.2:

  • Wrongly placed extension. Breakage is limited
    • Violation type:
    • Code:
      ## Old:
      interface org.xwiki.xar.XarEntryTypeResolver

      ## New:
      interface org.xwiki.xar.XarEntryTypeResolver


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

  • Cami Andrei
  • Clemens Robbenhaar
  • Damoebai¬∑Cloud
  • Guillaume Delhumeau
  • Jarle Sandmo
  • Joan
  • Manuel Leduc
  • Marius Dumitru Florea
  • Simon Urli
  • Thomas Mortagne
  • Varad Thokal
  • Vincent Massol
  • xrichard

Get Connected