Migrating Confluence Space

Options

1. We can export a Confluence space in HTML format.
   a. Useful if you want to convert your space into a static website or migrate to SharePoint.

2. We can export a Confluence space in XML format.
   a. Works best if you need to import the space into another Confluence site.

3. We can export a Confluence space in PDF format.
   a. Good to use if you're trying to create a user manual from the technical documentation.

Export Content to Word, PDF, HTML and XML - From Data Center

Export Content to Word, PDF, HTML and XML - From Cloud

Considerations:

1. HTML format

   1. Page comments are currently not being exported during HTML export

   2. Migrating to SharePoint will require converting all .html files to .aspx files.

      1. May require scripting. See Confluence to SharePoint Online Migration for reference

2. XML format

   1. The PES space is huge and cannot readily be imported into another space due to size.

   2. Export from Data Center sometimes doesn’t pick up all pages.

   3. There are plugins in the Bridge and Build Confluences that are not available in Prod Confluence so some content may not display or display correctly.

   4. Importing a space into the Prod instance will require users to have an account to access Confluence.

   5. XML exports do not include Team Calendars.

   6. Users and permissions are not imported.

   7. Templates are not exported

3. PDF format

   1. You can add a title page, table of contents, and customized headers and footers to the PDF output.

   2. For more advanced customizations, you can apply Cascading Style Sheet (CSS) modifications.

   3. These customizations are specific to each space, and you need the 'Space Administrator' permission to apply these customizations.

   4. For more information, see Customize exports to PDF.

4. There may be documentation spread across individual Personal spaces.

Recommendations

This would apply for ANY of the options above:

1. Identify the pages needed to retain.

2. Copy/move them to a new space created for this purpose.

   1. Pages from multiple spaces can be moved to this new space.

3. If wide access is needed, migrate the content to SharePoint.

4. If targeted access is needed and we have available licensing, import the space into a lower Confluence environment to check for issues. If no issues are found, import into a new space in Prod.