Import XWiki Pages

Last modified by Eleni Cojocariu on 2026/03/19 08:46

Steps

To import wiki Pages:

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

    import-menu-item.png

  3. Click on "Choose File" button to select the XAR package.

    package-imported.png

  4. Click on the package uploaded under "Available Packages", and check the "Package Content".

    package-content.png

  5. Unselect/select the Pages to import. By default, all Pages are selected. You can choose "None" or "All" to select/deselect, or use the box with the Tick icon.

    selected-pages.png

  6. Choose what action to take "when a Page already exists in the wiki". This option refers to situations when a Page with the exact same Page reference (i.e., in the same location within the wiki) already exists.

    options-importing-package.png

    • "Add a new version to the existing page (if different)".
      • Select this if you want to add a new version to the existing Page, but only if the content differs from the current version. This will maintain the Page's existing history and create a new revision for the changes.
    • "Replace the page history with the history from the package".
      • Select this if you want to replace the Page history with the history from the imported package. If you don't select this, the newly imported Pages will have the version "1.1" instead.
    • "Reset history to version 1.1".
      • Choose this option if you want to reset the Page's history and start from version "1.1". This will discard any existing history and treat the imported Page as the first revision.
    • If you want to keep the author of the imported Pages, make sure to check the "Import as backup package" option. Otherwise, the author of the Page will be set to the user performing the import.
  7. Click "Import" to import all the selected 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, during the import process, your rights might be changed if the import includes different rights configurations. If this happens, you may need to log out and log in again to apply the updated rights.

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 right?

For imports for Pages with Programming Right 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