Import XWiki Pages

Last modified by Eleni Cojocariu on 2026/09/07 20:57

Steps

To import wiki Pages from a XAR package, with the options that decide what happens to Pages the wiki already has:

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

    The Content menu of the Administration with the Import entry highlighted

  3. Click the "Choose File" button and select the XAR package.

    The Upload a new package area with the Choose File button highlighted

  4. Click the package listed under "Available packages" to display its "Package Content".

    The uploaded archive under Available packages and the Package Content panel it opens

  5. Select the Pages to import. Every Page is selected by default: use "none" and "all", or the box with the Tick icon in front of a Page.

    The Package Content tree with the none and all links and a Page tick box highlighted

  6. Choose what action to take "when a Page already exists in the wiki".

    The three options offered when a Page already exists in the wiki, highlighted

  7. Check "Import as backup package" if the imported Pages have to keep their authors.

    The Import as backup package checkbox highlighted

  8. Click "Import".
  9. Check the import report, which counts the Pages installed, skipped and in error, and lists every installed Page as a link to it in the wiki.

    The import report, with the counts of installed, skipped and failed Pages and the list of installed Pages

FAQ

What should I do if my wiki is empty and this is my first import?

If your wiki is empty and this is your first import, you will need to log in as a superadmin to perform the first import, as there are no users defined in the wiki at this time.

Can imports affect rights?

Yes, an imported package can carry its own rights configuration. If your own rights change, log out and log in again to apply them.

What should I do if I get a 'Java heap space Out Of Memory' exception?

If you get a 'Java heap space Out Of Memory exception' you'll need to increase the memory allocated to the JVM running XWiki.

How to handle imports for Pages with Programming Rights?

For imports for Pages with Programming Rights you need to ensure that the user performing the import has the necessary Programming Rights.

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