<insert description of release here>

New and Noteworthy (since XWiki Enterprise 3.2)

Improvements to the Extension Manager

The Extension Manager has been improved on all fronts, from the internal management of extensions, to the administration UI, and to the XWiki Extension Repository. Now the extensions wiki is enabled by default as a source for extensions, although only a handful of extensions have been validated at the moment.

First version of the App Within Minutes wizard

After the introduction of the new class editor and the live table generator, this release brings the App Within Minutes wizard tying all the other aspects making up the App Within Minutes feature. The wizard helps you create collaborative web applications within minutes, based on XWiki's powerful structured data management system.

Start by going to the App Within Minutes home page. There you can see listed the existing applications. Click on the "Create Application" button to start the wizard.


In the first step you have to provide the application name, which will determine the application home page URL and the application space. Each application is mapped to an XWiki space.


In the second step you define the application structure, i.e. the type of data the application will handle. At the end of this step the wizard will create for you the template and the sheet that will be used to create new application entries.


In the last step you customize the way the home page of your application will look like. You can choose which columns to display in the entries live table.


At the end the wizard takes you to the home page of your application, which is the place from where you can manage the application data: edit the application structure, add new entries, edit or delete existing ones.


New User Interface for the Extension Manager

Although there's no back-end repository where to search for new extensions yet, the new UI for the Extension Manager is starting to shape up. The previous experimental UI has been replaced by a new category in the Administration dedicated to the extension manager, with three different sections.




Link Checker

It's now possible to check the statuses of all external links found in your wiki.


FAQ Application

A new FAQ application is now made available (but not bundled by default in XWiki Enterprise):


Better support for exporting CJK documents as PDF

CJK characters, shorthand for Chinese, Japanese and Korean, need special fonts not provided in the standard 14 fonts required by the PDF specification, nor in the FreeFonts distributed and enabled by default with XWiki. Starting with this version we also distribute three new free fonts, along with the configuration needed to enable them for their target languages.


Updated the installation process of Workspaces

The Workspace Application requires that an admin provides the initial workspace template (as before), but now it can be anything the admin wants to use as base. The admin only has to rename it to "workspace-template.xar" and attach it to the WorkspaceManager.Install page. The workspace-related pages and settings will be applied to the template automatically.

Debian packages

Starting with 3.3 Milestone 1 Debian packages and repositories are released.

You can add one of the following list files to /etc/debian/apt/source.list.d/:

sudo wget http://maven.xwiki.org/stable/xwiki-stable.list -P /etc/apt/sources.list.d

LDAP user membership improvements

Organization unit and search filter support have been added in the group membership mapping settings. To use them, replace the group DN with an organization unit DN or with any search filter.

Attachments improvements

Since the filesystem attachment storage allows uploading very large files, a necessary improvement is to be able to pause and resume downloads. Starting with this version, it is possible to do so, since the /download/ action now respects the Range HTTP header.

Several bugs with downloading attachments when the filesystem storage is enabled have also been fixed, making this feature ready for production use.

Link Checker

It's now possible to tell XWiki to check for validity of external links found in the Wiki (to verify broken links for example). This is implemented through a Link Checker Transformation.

It's not enabled by default. To enable it, edit the xwiki.properties file and add linkchecker to the list of transformations to execute. For example:

rendering.transformations = macro, icon, linkchecker

Note that there's no UI for it yet (planned for 3.3 Milestone 2) but the Link States can be access through a Script Service. For example from Velocity:

#set ($states = $services.linkchecker.getLinkStates())

For Developers

<developer feature N>

<description of developer feature N>

Deprecated and Retired projects

<description of deprecated and retired projects>


The following dependencies have been upgraded:

  • <list libraries that have been upgraded>


<other stuff to add and link to JIRA for all issues fixed>


The following translations have been updated: 

Supported Browsers

Here's the list of supported browsers for this version (i.e. browsers that we've tested as working):

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

Here's the list of supported browsers for this version (i.e. browsers that we've tested as working):

Internet Explorer
Internet Explorer

Known issues

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 xwiki.store.migration.databases=all to your xwiki.cfg file or explicitly name all databases to be migrated as in xwiki.store.migration.databases=db1,db2,....

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

Always make sure you compare your xwiki.cfg and xwiki.properties files with the newest version since some configuration parameters were added. Note that you should add xwiki.store.migration=1 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 <projet> <version>

<issues specific to the project>

API Breakages

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

<clirr output here>

Get Connected