Release Notes for XWiki 7.1 Milestone 1

Version 37.1 by Gabriela Smeria on 2015/05/04
Warning: For security reasons, the document is displayed in restricted mode as it is not the current version. There may be differences and errors due to this.

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.

<insert description of release here>

New and Noteworthy (since XWiki 7.0)

Full list of issues fixed and Dashboard for <version>.

<feature N>

<description of feature N>


  • The Script Macro has been improved to return any type of value even no binding is used to output content.
  • The default Java version triggered as dependency for the Debian packages is not Java 8
  • In the Administration Application, when you change the space you are administrating, you don't lose the current section anymore (if the current section exists in that space).


  • In edit mode, Password fields do not display the obfuscation placholder () anymore when the password value is empty. For example this removes the confusion when editing the Mail Admin UI and users were thinking that the SMTP Server password was set.
  • Not existing document won't end up in the document cache anymore. That mean request lots of not existing document won't ditch "real" documents from the cache anymore.
  • The WatchList application now uses the new Mail API instead of the old and deprecated Mail Plugin.
  • The WatchList Realtime notification option has been reworked and the previous performance penalty has been removed.
  • In App Within Minutes Application, the newly created applications don't have 'App Within Minutes' as parent, but the webhome page of the current wiki and their homepage title doesn't contain the word 'Home' anymore.

See the full list of JIRA issues fixed in this release.

For Developers

<developer feature N>

<description of developer feature N>

Deprecated and Retired projects

<description of deprecated and retired projects>


  • The XAR plugin's verify mojo has been improved to allow passing a list of regexes to identify content and technical pages. For example:
       <!-- Consider all pages named *Translations as content pages by default -->
       <!-- The EditTranslations page is not a Translation page and thus not a content page! -->
  • New $services.rendering.escape($content, $syntax) method to escape XWiki syntax. See the documentation.
  • The HTML5 renderer is now bundled in XWiki Enterprise.
  • Added a new objectPolicy=updateOrCreate parameter to the save action that allows editing and creating objects in one request. For more details, see the documentation.
  • It is now possible to select the output syntax of a skin, in order to use the correct renderer.
  • Ability to register a custom Resource Type.
  • The WebJar integration now registers a webjar URL type using a Resource Handler (it was reusing the bin URL type before). The new WebJAR URL format is http://<server>/<context path>/webjars/<path/to/resource>[?version=<version>&evaluate=true|false]. Note that you should use the exposed Script Service method to compute a WebJAR URL.
  • The mime type of uploaded attachment is now automatically stored in the database and won't be recalculated each time it's asked. Also a new API has been introduced in com.xpn.xwiki.doc.XWikiAttachment to change it if needed.
  • The ConfigurableClass mechanism now supports adding field hints / descriptions. See the documentation.
  • The xwiki-platform-legacy-crypto-script legacy module has been removed as it was conflicting with the Bouncy Castle 1.52 upgrade and we considered that there was little chance that this module was used anywhere in any extension. If by chance (so to speak) you were using it, you'd need to use the newer xwiki-platform-crypto-script module and rebuild your extension with it.


The following dependencies have been upgraded:


The following translations have been updated: 

Tested Browsers & Databases

Failed to execute the [velocity] macro. Cause: [The execution of the [velocity] script macro is not allowed in [xwiki:TestReports.ManualTestReportSummaryXWiki71M1]. Check the rights of its last author or the parameters if it's rendered from another script.]. Click on this message for details.

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

BrowserTest Result
Chrome30.pngGoogle Chrome 41Not Tested
Firefox30.pngMozilla Firefox 37Jira Tickets Marked as Fixed in the Release Notes
IE30.pngInternet Explorer 8Not Tested
IE30.pngInternet Explorer 9Not Tested

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

DatabaseTest Result
hypersql.pngHyperSQL 2.3.2Jira Tickets Marked as Fixed in the Release Notes
mysql.pngMySQL 5.6.24Not Tested
oracle.pngOracle 11.2Not Tested
postgresql.pngPostgreSQL 9.4.1Not Tested

For the full list of tests see this page.

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.

Issues specific to XWiki <version>

<issues specific to the project>

API Breakages

The following APIs were modified since <project> <version - 1>:

<clirr output here>

Get Connected