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 main focus of this version was developer tools such as introducing support for exposing WebSocket endpoints as XWiki components, making easier to handle skin extensions in asynchronous HTML content, a more accurate strategy to select between several similar Java methods in Velocity scripts and support for ConfigurableClass in all administration pages. It also comes with various bug fixes and improvements.

New and Noteworthy (since XWiki 13.6)

Full list of issues fixed and Dashboard for XWiki 13.7.

For Users

No changes!

For Admins

  • $changeObject.getValue('summary')

For Developers

Failed to execute the [include] macro. Cause: [Current user [null] doesn't have view rights on document [Document xwiki:ReleaseNotes.Code.Change.ChangeDisplayerSimple]]. Click on this message for details.


  • History delete event: It's now possible to be notified when a range of document history versions is about to be deleted using the event org.xwiki.bridge.event.DocumentVersionRangeDeletingEvent. See Model Bridge API for more details.

  • NamespaceURLClassLoader#isClosed(): NamespaceURLClassLoader now exposes an API to know if it has been closed.

  • Allow to recompute average ratings from script service: A new API methods has been added in Ratings script service to allow computing back the average ratings when needed.

    The signature of the method is the following:

         * Recompute the average rating of a reference.
         * Note that this method can be resource consuming if the set of data is large.
         * @param reference the reference for which to recompute the average ratings.
         * @return the average rating in an optional or an empty optional in case of error.
         * @since 13.7RC1
         * @since 13.4.3
         * @since 12.10.9

       Optional<AverageRating> recomputeAverageRating(EntityReference reference)
  • Allow to store Like average xobjects: Like implementation is based on Ratings, and until this version the configuration of Ratings we were using was hardcoded.

    We provide in this version 2 new properties that allow to store the average ratings xobjects related to the Like information: those xobjects can notably be used to perform HQL queries with the total number of likes in pages, since this data is stored in them.

    We only provide those properties as an experimental feature: it might be removed later, by providing a cleaner API for this usecase.

    The properties are the following:

    ## Specify if the average rating should be stored or not for likes. Default value is false.

    ## Specify where the average ratings should be stored. Default value is xobject. Possible values are currently solr or xobject.


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:

 BrowserTested on:
Edge30.pngMicrosoft Edge 92Not Tested
Chrome30.pngGoogle Chrome 92Jira Tickets Marked as Fixed in the Release Notes
IE30.pngInternet Explorer 11Tests run and results
Firefox30.pngMozilla Firefox 91
Safari30.pngSafari 14Not Tested

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

 DatabaseTested on:
hypersql.pngHyperSQL 2.5.2Not Tested
mariadb.pngMariaDB 10.6Tests run and results
mysql.pngMySQL 8
postgresql.pngPostgreSQL 13Jira Tickets Marked as Fixed in the Release Notes
oracle.pngOracle 19cNot Tested

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

 Servlet ContainerTested on:
tomcat-icon.pngTomcat 9.0.52
jetty-icon.pngJetty 9.4.29 (XWiki Standalone packaging)
jetty-icon.pngJetty 9.4.29Not 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 13.6:

Unknown Criticality

These violationq are missing a criticality and need to be fixed.

  • Unstable API: this API was not properly designed and shouldn't have returned that in first place.
    • Violation type:
    • Code:
      ## Old:
      method javax.mail.internet.InternetAddress throws

      ## New:
      method void throws
  • Unstable API: this API was not properly designed and shouldn't have returned that in first place.
    • Violation type:
    • Code:
      ## Old:
      method javax.mail.internet.InternetAddress


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

  • Eduard Moraru
  • Manuel Leduc
  • Marius Dumitru Florea
  • Simon Urli
  • Teo Caras
  • Thomas Mortagne
  • Vincent Massol
  • slauriere
  • urs19work

Get Connected