Release Notes for XWiki 16.4.0

Last modified by Ilie Andriuta on 2024/06/07

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.

This release contains a long awaited feature allowing to manually order the pages displayed in a page tree. It also contains a few improvements and important bug fixes such as a fix for the duplicated attachments on the filesystem storage.

New and Noteworthy (since XWiki 16.3.1)

Full list of issues fixed and Dashboard for 16.4.0.

For Users

No changes!

For Admins

Pinned Pages

You can now manually change the order of the pages displayed in all the page trees used in the wiki (Navigation tree, Breadcrumbs tree, Page Index Tree, etc). It's not a fully manual order but rather a mix of manual and automatic order: some pages, we call them "pinned" pages, are displayed first (in manual order), followed by the rest of the child pages in automatic order (e.g. by page title). You can pin pages at any level in the page tree hierarchy using the dedicated administration section. For a given parent (nested) page the list of pinned child pages is saved in its page preferences. The list of top level pinned pages are saved in the wiki preferences.

The screenshots show the effect of pinning the Nested1/Nested2/Pinned Page Example page in various trees in the XWiki UI (namely: Navigation tree, Breadcrumbs tree and Page Index Tree).

Besides the new administration section, we also updated the Navigation Panel administration section to allow you to change the order of the top level pages and save this manual order using pinned pages. Basically, whenever you move a top level page to a new position, that page and all its previous sibling pages become pinned. You can of course unpin a top level page.


  • Attachment storage size reduced: The current version of each attachment used to be duplicated in the storage, it's not the case anymore. See Filesystem. Note that it only applies to new attachments, existing attachments are not migrated during upgrades.

For Developers

No changes!


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:
Firefox30.pngMozilla Firefox 126Not Tested
Chrome30.pngGoogle Chrome 125Tests run and results
Edge30.pngMicrosoft Edge 125Jira Tickets Marked as Fixed in the Release Notes
Safari30.pngSafari 17Not Tested

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

 DatabaseTested on:
hypersql.pngHyperSQL 2.7.2Not Tested
mariadb.pngMariaDB 11.3Jira Tickets Marked as Fixed in the Release Notes
mysql.pngMySQL 8.4Not Tested
postgresql.pngPostgreSQL 16Tests run and results
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.89
jetty-icon.pngJetty 10.0.20 (XWiki Standalone packaging)Not Tested
jetty-icon.pngJetty 10.0.20Not Tested

Security Issues

Security issues are not listed in issue lists or dashboards to avoid disclosing ways to use them, but they will appear automatically in them once they're disclosed. See the XWiki Security Policy for more details.

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

No API breakage since XWiki 16.3.1.


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

  • Josué Tille
  • LucasC
  • Manuel Leduc
  • Mariana Batista
  • Marius Dumitru Florea
  • Mend Renovate
  • Michael Hamann
  • Nuria Rey
  • Oana-Lavinia Florean
  • Pierre Jeanjean
  • Raphaël Jakse
  • Simon Urli
  • Simpel
  • Thomas Mortagne
  • Vincent Massol
  • daeseong.choi

Get Connected