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 adds support for renaming apps created with App Within Minutes and brings improvements to the WYSIWYG editor: inline editing of the Box Macro title and macro category count displayed by the Macro Selector. Advanced users can now copy the page reference from the Information tab at the bottom of each page.

New and Noteworthy (since XWiki 11.0.3)

Full list of issues fixed and Dashboard for 11.1.

For Users

Rename Application

Starting with this version you can rename/move an application created with App Within Minutes by renaming/moving its home page. Be aware though that the application code is going to be regenerated if you rename the application, which means that code customizations will be overwritten as a consequence.

Checkout the App Within Minutes documentation for more information.

Inline editing of title for Box Macro

The title of the Box macro is now editable directly in the WYSIWYG editor, as it already was for its content.

Simplified Page Rename

The Rename Page dialog has been simplified:

  • the "Preserve Children" option is visible only if the page to rename has child pages.
  • the "Update Links" option is now visible only to advanced users. For simple users the back-links are always updated.

Macro Category Count

When inserting a macro through the WYSIWYG Editor the macro selector now shows the number of macros available in each category.

Display page reference in the information viewer

You can now retrieve quickly the page reference of any page by going to the Information tab. The reference is by default displayed to the local wiki, but you can switch it to get a global reference for all wiki in a farm. The right button allow you to quickly copy it to the clipboard.


  • Job Waiting Information: You might now see a new information box instead of the progress bar if another job is currently performed against the pages you selected. In that case, you have to wait that the other job is finished or cancelled before yours start. The UI would refresh automatically.

For Admins

No changes!

For Developers

Inline editing of macro parameters

It is now possible to allow inline editing of macro parameters when using the WYSIWYG editor. In order to do that, we reuse the same principle as for allowing inline editing of content in macro: you have to specify the type of the macro parameter by using @PropertyDisplayType on the parameter, and then you have to specify the metadata to put where the macro parameter is used in the UI, by using the AbstractMacro#getNonGeneratedContentMetaData("parameterName") method.

Page Count for Data Types

The Data Types live table now shows the number of pages that use each data type.

Default Class Sheet Shows Object Count

The default class sheet now shows the number of objects (of the current type) found on each page.


  • Copy / Rename Events: The refactoring module introduces dedicated events for document copy and rename operations. Checkout the documentation for more information.

  • XClass Rename: The xobjects of an xclass are now updated automatically when the xclass is renamed if:

    • the xclass is not moved to a different wiki
    • the "Update Links" option is checked (which is the case by default)

    Renaming xclasses is still considered a dangerous operation though, because xclasses are often used in scripts, which are not updated when an xclass is renamed.


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:

  • French
  • Norwegian
  • Russian
  • Ukrainian

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.

Issues specific to XWiki 11.1RC1

Introduction of the Event Stream Store

The Activity Stream and Watchlist features have been replaced by the Notifications feature back in XWiki 10.9. However, for technical reasons, we were still using the old Activity Stream store. We have now removed it in favor of a new Event Stream Store.

If you're upgrading from an older version of XWiki, you must to modify your hibernate.cfg.xml file.

You need to remove this line:
<mapping resource="activitystream.hbm.xml"/>

And replace it by:
<mapping resource="eventstream.hbm.xml"/>

Local resource access for modification date

We introduced in this version a new mechanism to handle resource caches in the browsers.

By default this mechanism will access the local resource file in order to check their modification date an use it in the URL. If you find some performance issue, especially if XWiki is running on an old system or hard drive, you can disable this mechanism by changing this new property in

#-# [Since 11.1RC1]
#-# Whether a the last modified date of the file to be loaded should be checked and put in the URL query parameter.
#-# Disabling this might improve a bit the performance on some old hard drives, or custom filesystem, however
#-# it might imply the need to force-reload some resources in the browser, when migrating.
#-# The default is:
# url.useResourceLastModificationDate=true

In that case, please leave us a comment on this JIRA issue, or in the forum so we know about it.

API Breakages

The following APIs were modified since XWiki 11.0.3:

  • Not a breakage.
    • Violation type:
    • Code:
      ## Old:
      @interface org.xwiki.stability.Unstable

      ## New:
      @interface org.xwiki.stability.Unstable
  • Not a breakage: class moved to a legacy module
    • Violation type:
    • Code:
      ## Old:
      class org.xwiki.velocity.introspection.AbstractChainableUberspector
  • Not a breakage: class moved to a legacy module
    • Violation type:
    • Code:
      ## Old:
      interface org.xwiki.velocity.introspection.ChainableUberspector
  • Not a breakage: class moved to a legacy module
    • Violation type:
    • Code:
      ## Old:
      class org.xwiki.velocity.introspection.ChainingUberspector
  • Not a breakage: class moved to a legacy module
    • Violation type:
    • Code:
      ## Old:
      class org.xwiki.velocity.introspection.LinkingUberspector
  • The annotation has been added in box macro but is used in Code Macro. It's not an api breakage.
    • Violation type:
    • Code:
      ## Old:
      method void @ org.xwiki.rendering.macro.code.CodeMacroParameters

      ## New:
      method void @ org.xwiki.rendering.macro.code.CodeMacroParameters
  • The annotation has been added in box macro but is used in RSS Macro. It's not an api breakage.
    • Violation type:
    • Code:
      ## Old:
      method void @ org.xwiki.rendering.macro.rss.RssMacroParameters

      ## New:
      method void @ org.xwiki.rendering.macro.rss.RssMacroParameters


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

  • Adel Atallah
  • Camelia Andrei
  • Clemens Robbenhaar
  • DenisF
  • Ecaterina Moraru (Valica)
  • Eduard Moraru
  • Guillaume Delhumeau
  • Jarle Sandmo
  • Marius Dumitru Florea
  • Rostyslav Fitsyk
  • Simon Urli
  • slauriere
  • Thomas Mortagne
  • Vincent Massol
  • xrichard
Created by Vincent Massol on 2019/02/03

Get Connected