Import Confluence Space from Export XML or HTML Zip File

[Carlos Castellanos (X-Link)]

I exported several Confluence Spaces from NextGen (Cloud based) version. There are two spaces of interest. The export produced two .ZIP files of 12GB and 23GB.

I have been trying to import at least one of the files using the HTML importer, to no avail. That was done by extracting the -HTML.zip file from the larger zip file. I had tried importing the raw ZIP file and/or individual HMTL.zip or XML.zip internal files and still fails or simply do not complete.

What is the best way I can use to recover my spaces?

[Brant Schroeder]

@Carlos Castellanos (X-Link) welcome to the Atlassian community

Per Atlassian's documentation on exports.

1. The PDF option is good to use if you're trying to create a user manual from the technical documentation you keep in Confluence Cloud.

2. The CSV export is best if you want to import a space into another Confluence Cloud instance.

3. The HTML export is useful if you want to convert your space into a static website.

4. The XML export option works best if you need to import the space into a Confluence Data Center instance.

I would suggest trying to use your XML or if you can still export the space to do it via CSV to import it into your cloud instance.

Helpful documentation:

• https://support.atlassian.com/confluence-cloud/docs/export-content-to-word-pdf-html-and-xml/ 
• https://support.atlassian.com/confluence-cloud/docs/import-a-confluence-cloud-space/ 

[Carlos Castellanos (X-Link)]

Thanks @Brant Schroeder 

[Carlos Castellanos (X-Link)]

I will retry using the XML portion of the export.

I will check if I produced a CSV version

[Carlos Castellanos (X-Link)]

Trying this procedure

https://support.atlassian.com/confluence-cloud/docs/import-a-confluence-cloud-space/ 

pointing to XML.zip file

Let's see

I tried the procedure you shared @Brant Schroeder 

Used XLM file and it was doing fine in the import process until I got this error

There was an error during import. Please see below for more information.

ERROR: insert or update on table "spaces" violates foreign key constraint "fk7ndewmrl3hqcpwc8eydn9mv8j

[Brant Schroeder]

@Carlos Castellanos (X-Link) This is an older bug that I found that you might try the workaround to see if this fixes your issue https://jira.atlassian.com/browse/CONFCLOUD-78184   Based on what is shared it should be resolved.

[Carlos Castellanos (X-Link)]

Thanks and will check @Brant Schroeder 

[Carlos Castellanos (X-Link)]

Answer moved to a reply

[Kristian Klima]

Hi @Carlos Castellanos (X-Link) 

The HTML import feature was designed to import content from non-Confluence environments. The use case here is to enable (make easier) migration of content. And it works on the space level.

To move Confluence spaces between/among sites/installations on both Cloud and Data Center (and Server in the past), XML used to be the only method.

For Cloud to Cloud, you can now also use the CSV method.

So as @Brant Schroeder suggested, try importing either XML or CSV for a full space export import.

HOWEVER

If you want to export/import individual pages/sections, you can customize the export to include just the selected pages/sections as you set up the export.

You cannot import individual pages extracted from XML/CSV exports. So you need to take care of that at the export phase.

It would still produce a Zip file which you can import into another site.

Alternative 3 :)

There's this app called Space Sync for Confluence by Ricksoft that allows you to synchronize content between two spaces - even across different Confluence sites. Every synchronization is preceeded by... moving content from one space to another.

So you may look into that too for a one-off use of the app. One of the advantages is that you can set up the target space prior to the initial sync.

More on the space syncing in my article on space synchronization.

[Carlos Castellanos (X-Link)]

Thanks @Kristian Klima