Upgrade the Flavor Using the Export/Import Method
Last modified by Eleni Cojocariu on 2026/08/13 15:14
Steps
To upgrade a wiki by migrating its content into a new instance instead of upgrading the flavor in place:
- Check the limitations and risks of this method.
- Identify all the content created on the old instance, and confirm that you know exactly what has to be migrated.
- Export that content as a XAR file from the old instance.
- Install a new instance of the version you are moving to.
- Import the XAR file into the new instance.
- Check the new instance, page by page, against the list of content you identified.
The new instance then holds your content on the new version, without any of the data migrations a regular upgrade would have applied.
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 limitations and risks when using this method to upgrade.
Should default XWiki Pages be included in the export/import?
No. Import only the Pages you created: the default Pages would overwrite the ones the new XWiki installation provides.
More
To find more about the current topic, you can search or use the table below and filter the columns to narrow your choices.
