Wiki source code of Import XWiki Pages

Last modified by Eleni Cojocariu on 2026/08/14 17:53

Hide last authors
Eleni Cojocariu 1.20 1 To [[import>>documentation.xs.admin.imports.WebHome]] wiki Pages:
Eleni Cojocariu 1.1 2
Eleni Cojocariu 2.19 3 1. [[Administer your wiki>>xwiki:documentation.xs.admin.base.content-organization.administer-wiki.WebHome]].
Eleni Cojocariu 1.1 4 1. Select "Content", and then select "Import" from the dropdown.(((
Eleni Cojocariu 1.3 5 {{image reference="import-menu-item.png" size="medium" alt="The Content menu with the Import item highlighted"/}}
Eleni Cojocariu 1.1 6 )))
Eleni Cojocariu 1.11 7 1. Click on "Choose File" button to select the [[##XAR## package>>extensions:Extension.XAR Module Specifications]].(((
Eleni Cojocariu 1.3 8 {{image reference="package-imported.png" size="medium" alt="The user interface of the Import feature with the button Choose File highlighted"/}}
Eleni Cojocariu 1.1 9 )))
Eleni Cojocariu 1.3 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"/}}
Eleni Cojocariu 1.1 12 )))
Eleni Cojocariu 1.9 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 "/}}
Eleni Cojocariu 1.3 15 )))
Eleni Cojocariu 2.9 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.(((
Eleni Cojocariu 1.9 17 {{image reference="options-importing-package.png" size="medium" alt="The posible options to select when a page already exists in the wiki"/}}
Eleni Cojocariu 1.5 18
19 * "Add a new version to the existing page (if different)".
Eleni Cojocariu 2.20 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.view-history.WebHome]] and create a new revision for the changes.
Eleni Cojocariu 1.5 21 * "Replace the page history with the history from the package".
Eleni Cojocariu 2.21 22 ** Select this if you want to replace the [[Page history>>documentation.xs.user.base.page.view.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.view-history.major-minor-versions.WebHome]] "1.1" instead.
Eleni Cojocariu 1.5 23 * "Reset history to version 1.1".
Eleni Cojocariu 2.21 24 ** Choose this option if you want to reset the [[Page's history>>documentation.xs.user.base.page.view.view-history.WebHome]] and start from [[version>>documentation.xs.user.base.page.view.view-history.major-minor-versions.WebHome]] "1.1". This will discard any existing history and treat the imported Page as the first revision.
Eleni Cojocariu 2.7 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.
Eleni Cojocariu 1.3 26 )))
27 1. Click "Import" to import all the selected Pages.

Get Connected