Last modified by Thomas Mortagne on 2017/03/24

ContentsThe [toc] macro is a standalone macro and it cannot be used inline. Click on this message for details.

Release Notes for XWiki Enterprise 1.7

Changes since XWiki Enterprise 1.6

1. New Rendering improvements

  • XWiki Syntax 2.0 improvements:
    • Allow wiki syntax inside links. Example of an image link:
[[image:[email protected]>>reference]]
    • New syntax for tables. Example:
|= row1 |= row2
| cell1 | cell2
    • Images can be defined as URLs. Example:

You'll find information on how to enter content using the new syntaxes in the Page Editing Guide.

  • New Macros:
    • Code macro (experimental). Allows to perform syntax highlighting of the content. Only supports HTML, XML and PHP for the moment. Example:
{{code language="xml"}}
    • Script macro. The new script macros add the ability to use any scripting language supporting JSR-223. For now the default XWiki distribution comes with only a Groovy 1.6 support but it easy to add support for other language (like ruby, python, etc.) simply by adding the corresponding engine and implementation. See
      To use the new script macro:
{{script language="groovy"}}
  println "Hello World"
or you can also use the Groovy macro alias:
  println "Hello World"
    • Box macro. This macro allow to put content in a visual container. Example:
* wiki
* content

2. New WYSIWYG editor improvements

  • Link feature implemented (link to wiki page, web page, email).
  • Lots of bug fixes.

    The look & feel is not the final one. Please look at the new WYSIWYG Design page to see what it'll look like (except for the colors which will be different). To start using the new editor, check out the Page Editing Guide. Again this is work in progress but we'd like as much feedback as possible. Please raise any issue you find in JIRA.

3. WebDAV Support

XWiki now expose a WebDAV server interface. This means you can now access/edit/delete page sources and attachments from any WebDAV client.

4. Usability Improvements

  • New Attachment view in the Index: you can now see all the attachments of the wiki in the index, under the "Attachment" tab.

4. Other Changes

  • Multiwiki (a.k.a farm mode or virtual mode) is now available without using subdomains for wikis. Note that this option is available from xwiki.cfg and not enabled by default. Example of URLs (the "/wiki/" part is configurable):
  • Groovy upgrade : The groovy engine has been upgraded to the last 1.6 beta version. You can now use all the new features of groovy as well as speed improvements and bugfixes from groovy 1.0 to 1.6 beta 2. See for more information.
  • Reorganized, documented and enhanced * Added a ROOT webapp to the standalone distribution.

5. Important Bugfixes

  • Saving a blank wiki page throws exception in Oracle
  • Registration is still possible when right to register for Unregistered user is explicit set to deny
  • Documents with name with spaces or other special chars can't properly save added image in WYSIWYG editor
  • Support of dots in ldap login has introduce a security hole
  • SMTP server address is not re-read when it's changed in global preferences
  • Watchlist update sent by email does not contain the full path to a changed attachment
  • Wrong user name is inserted in group during LDAP membership synchronisation

Known issues

Common Migration notes

If you're running in a multiwiki setup you'll also need to define the property to your xwiki.cfg file or explicitely name all databases to be migrated as in,db2,....

You may also want to import the default wiki XAR in order to benefit from improvements listed above.

Always make sure you compare your xwiki.cfg file with the newest version since some configuration parameters were added. Of note, 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.

Get Connected