Wiki source code of Import XWiki Pages

Last modified by Eleni Cojocariu on 2026/10/21 15:16

Show last authors
1 To [[import>>doc:documentation.xs.admin.imports.WebHome]] wiki Pages from a [[##XAR## package>>doc:documentation.xs.admin.exports.export-content-xar-format.format-specifications.WebHome]], with the [[options>>doc:documentation.xs.admin.imports.import-xwiki-pages.options.WebHome]] that decide what happens to Pages the wiki already has:
2
3 1. [[Administer your wiki>>doc:documentation.xs.admin.base.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 of the Administration with the Import entry highlighted"/}}
6 )))
7 1. Click the "Choose File" button and select the ##XAR## package.(((
8 {{image reference="package-imported.png" size="medium" alt="The Upload a new package area with the Choose File button highlighted"/}}
9 )))
10 1. Click the package listed under "Available packages" to display its "Package Content".(((
11 {{image reference="package-content.png" size="extra" alt="The uploaded archive under Available packages and the Package Content panel it opens"/}}
12 )))
13 1. 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.(((
14 {{image reference="selected-pages.png" size="large" alt="The Package Content tree with the none and all links and a Page tick box highlighted"/}}
15 )))
16 1. Choose what action to take "when a Page already exists in the wiki".(((
17 {{image reference="options-importing-package.png" size="medium" alt="The three options offered when a Page already exists in the wiki, highlighted"/}}
18 )))
19 1. Check "Import as backup package" if the imported Pages have to keep their [[authors>>doc:documentation.xs.user.base.page.authors.WebHome]].(((
20 {{image reference="backup-package.png" size="medium" alt="The Import as backup package checkbox highlighted"/}}
21 )))
22 1. Click "Import".
23 1. 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.(((
24 {{image reference="import-result.png" size="large" alt="The import report, with the counts of installed, skipped and failed Pages and the list of installed Pages"/}}
25 )))

Get Connected