Upgrade the Flavor using the Export/Import Method

Last modified by Eleni Cojocariu on 2026/03/11 10:09

Tutorial

To upgrade your wiki instance by migrating the content using the export/reimport XAR:

  1. Check the limitations and risks of upgrading using this method.
  2. Identify all the content you have created on the old instance.
  3. Verify manually that you know exactly what content must be migrated.
  4. Export the existing content as a XAR file from the old instance.
  5. Install a new instance using the preferred method where the content will be migrated.
  6. Import the XAR file into the new instance.
  7. Check the new instance to confirm that all content was transferred correctly.
  8. Validate that no important data is missing or broken after the import.

FAQ

Is this a safe method to upgrade the flavor of the wiki?

No, the recommended way is to upgrade the flavor using the distribution wizard. There are limitatations and risks when using this method to upgrade.

Should default XWiki Pages be included in the export/import?

No, they should not be included. Make sure to only import your own content Pages and not the default XWiki pages since you’d overwrite the ones provided in new XWiki install.

More

To find more about the current topic, you can search or use the table below and filter the columns to narrow your choices.

Related

Get Connected