Steps

To export content in XAR format:

1. Administer your wiki.
2. Select "Content", and then select "Export" from the dropdown.

   

3. Select the Pages to export:
   • Use the "all/none" to select/deselect, or use the box with the Tick icon.

     

   • If the Page/s you want to export include extension Pages, it is useful to use the "Select from" dropdown described in the Export modal Page.
4. Configure the following settings as needed. These additional settings for exporting XARs are not available when exporting directly from viewing a Page.

   

   • "With history": You can include the Page history in the export. If not checked, only the latest version of a Page is exported.
   • "Target XWiki version": You can choose the version of XWiki where you want then to import the Pages:
     • Both options export the attachment history when "With history" is checked, but in different formats. Select "Below 12.0" when the archive is meant for an XWiki older than 12.0, which cannot read the format the other option writes.
   • "File name": Set a name for the XAR file.
5. Configure "More options" for exporting XARs:

   

   • "Description": The package description that will be displayed when importing the package.
   • "Author": The author displayed when importing.
   • "License": This refers to the content license applied to the package, which defines the terms under which the content can be used, modified, and distributed. Examples of licenses include LGPL, GPLv2, etc.
   • "Version": This refers to the version of the package, which is stored in the package descriptor. It indicates the specific version of the package and helps track updates or changes made to it.
   • "Backup package": This option ensures that the page author is preserved during the import process. It does not affect the exported content itself and can be modified before the import if needed.
6. Click on "Export" to export in XAR format, or exit the Page to discard.
7. Check that your browser downloaded the .xar archive, named after the "File name" setting. It is ready to be imported into a wiki.

FAQ

Do I need special rights to export content in XAR format?

Yes, the XAR export requires the administration right on the wiki and refuses the export without it. Because that right is required, the export does not filter the selection by your view right: every selected Page goes into the archive.

Why is the history missing from the Pages of my archive?

Because "With history" was left unchecked, which exports only the latest version of each Page. Import such an archive and each Page starts again from a single version.

Do the "Description", "Author", "License" and "Version" settings change my Pages?

No, they only describe the package and are displayed when importing it. The exported Pages are untouched.

Can I repeat an export without going through the selection tree again?

Yes, the export is also driven entirely from the URL, which makes it repeatable and scriptable. See Customizations for XAR Export Using URL Parameters.

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

• Export a Page.
• Import.
• Customizations for XAR Export Using URL Parameters.