First milestone of the XWiki Enterprise 3.1 version (Roadmap).

New and Noteworthy (since XWiki Enterprise 3.0)

OpenOffice based document export

Export your wiki documents to any type of document supported by OpenOffice using the OpenOffice server as a back end.

Groovy 1.7.10

ColorTheme improvements

"Add" menu entry can now be customizable from the ColorTheme wizard and has it's own variable.


Also, info, success, warning and error message colors can now be changed through ColorThemes variables.

General UI improvements

Several XWiki forms have been modified in order to be consistent with our Vertical Layout Usage Form Standard


  • Standardized vertical navigation menu layout, which will be used in M2 in administration, user profiles, and in the wiki index
  • Colibri is now the default base skin instead of Albatross
  • XWIKI-5859: Ability to have different panels in wiki and WYSIWYG edit modes

WYSIWYG content editor improvements

  • Better support for Opera, Chrome and Safari
  • Fixed several usability bugs

PDF export improvements

  • XWIKI-5782: PDF export ordered lists are not numbered in the same way as the wiki lists
  • XWIKI-5799: Underlined text has some additional white space before it when export to PDF
  • XWIKI-5844: PDF export sometimes broken when copy/pasting content from MS Office

Miscellaneous new features

tick Success macro, you can access this by writing {{success}}text here{{/success}}


  • Lucene search improvements
  • Enable preview office feature for all formats supporting by OpenOffice (especially docx, xlsx, pdf, pptx, odf, ods, odp)
  • Activity stream performance improvements and bug fixes
  • XAR import improvements (XWIKI-5845, XWIKI-5846)

For developers

  • XWIKI-2496: Specialized AppServerTrusted authenticator handling Kerberos principals
  • XWIKI-5758: Remove logging to the xwiki.log file in the log4j default configuration
  • XWIKI-5868: Add API for manipulating skin extensions as components
  • XWIKI-5810: Allow skin customization based on the current space name
  • XWIKI-5815: Add a Context macro
  • XWIKI-5900: Generic macro for displaying vertical navigation menus
  • XWIKI-5874: Add API to display document's titles in plain text without any markup
  • XWIKI-5819: Now the limit for nested macro calls is 100 instead of the default 20

Test Report

You can check the manual test report to learn about what was tested and the results on various browsers.

Backward Compatibility and Migration Notes


General Notes

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

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

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

API Breakages

The following APIs were modified since XWiki Enterprise 2.7:

Created by Caleb James DeLisle on 2011/05/03

Get Connected