Wiki source code of Import XWiki Pages

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

Show last authors
1 To [[import>>documentation.xs.admin.imports.WebHome]] wiki Pages:
2
3 1. [[Administer your wiki>>xwiki:documentation.xs.admin.base.content-organization.administer-wiki.WebHome]].
4 1. Select "Content", and then select "Import" from the dropdown.(((
5 {{image reference="import-menu-item.png" size="medium" alt="The Content menu with the Import item highlighted"/}}
6 )))
7 1. Click on "Choose File" button to select the [[##XAR## package>>extensions:Extension.XAR Module Specifications]].(((
8 {{image reference="package-imported.png" size="medium" alt="The user interface of the Import feature with the button Choose File highlighted"/}}
9 )))
10 1. Click on the package uploaded under "Available Packages", and check the "Package Content".(((
11 {{image reference="package-content.png" size="medium" alt="The files uploaded that under the Available Packages and their content in the Package Content"/}}
12 )))
13 1. 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.(((
14 {{image reference="selected-pages.png" size="medium" alt="The package content with the "/}}
15 )))
16 1. 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>>documentation.xs.user.base.page.linking-references.WebHome||anchor="PageReferences"]] (i.e., in the same location within the wiki) already exists.(((
17 {{image reference="options-importing-package.png" size="medium" alt="The posible options to select when a page already exists in the wiki"/}}
18
19 * "Add a new version to the existing page (if different)".
20 ** 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>>documentation.xs.user.base.page.view-page.view-history.WebHome]] and create a new revision for the changes.
21 * "Replace the page history with the history from the package".
22 ** Select this if you want to replace the [[Page history>>documentation.xs.user.base.page.view-page.view-history.WebHome]] with the history from the imported package. If you don't select this, the newly imported Pages will have the [[version>>documentation.xs.user.base.page.view-page.view-history.major-minor-versions.WebHome]] "1.1" instead.
23 * "Reset history to version 1.1".
24 ** Choose this option if you want to reset the [[Page's history>>documentation.xs.user.base.page.view-page.view-history.WebHome]] and start from [[version>>documentation.xs.user.base.page.view-page.view-history.major-minor-versions.WebHome]] "1.1". This will discard any existing history and treat the imported Page as the first revision.
25 * If you want to keep the [[author>>documentation.xs.user.base.page.authors-page.WebHome]] 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.
26 )))
27 1. Click "Import" to import all the selected Pages.

Get Connected