Import from Confluence

Last modified by Eleni Cojocariu on 2026/04/30 13:50

Content

Steps

Warning

Importing a Confluence instance is a multi-step process. This tool allows to import an export from Confluence into XWiki pages, but additional specific actions need to be handled, including supporting standard or custom Confluence macros. For large instances, some specific issues might occur, such as too long page names or hierarchies that cannot be imported or unsupported macros.

Information

XWiki SAS, a sponsoring company of the XWiki Open Source software, is providing software and services to help with the migration:

You can contact XWiki SAS on the XWiki SAS website: https://xwiki.com

To get started with the Confluence Import, you will need to install the Filter Streams Converter Application and this Confluence XML module. You can install these apps using the Extension Manager.

You then need to export your confluence data from the Confluence administration and upload the zip file to the XWiki server. Make sure you make it accessible to the user running your java process.

extensions.png

After you have installed the two extensions, click on the Filter Stream Converter entry from the Applications panel.

extensions.png

Follow these steps on the screenshot below:

  • Choose the "Confluence XML input stream (confluence+xml)" input type
  • Fill in the source field which contains "file:" followed by the path of the Confluence zip file, located on the machine where XWiki is running
  • Choose the "XWiki instance output stream (xwiki+instance)" output type to import the Confluence pages in your wiki

Note: in some cases, the Java Application server cannot access all the directories from your computer or server. You can try storing the file in a directory used by the application server (root directory of the application server or log directory). Alternatively it is also possible to make your file accessible on a web server and indicate the URL of that file.

filterconverter.png

After you have completed these steps, click the "Convert" button. After that, you will see the conversion progress. For example:

ws-mess.png

For example with the following initial page from Confluence:

confluence-page.png

You'll get the following page in XWiki after you've made the import:

wiki-page.png

You're all set! emoticon_smile

More

To find more about the current topic, you can search or use the table below and filter the columns to narrow your choices.

Get Connected