Backing up or restoring a single space? Use the new CSV space export/import!

[#1]

Hey everyone, my name is Steven and I’m a product manager on Confluence. We just released an update to exporting spaces intended for re-import into Confluence Cloud.

In space settings, you’ll now find an additional option to export your space to CSV. Going forward, this will be the preferred way for single space exports that you intend for re-import into Confluence Cloud as this format provides reliability, performance, and scale improvements over the existing XML space export format.

You’ll be able to import these CSV space exports into Confluence Cloud using the same import spaces UI in site administration.

If you are looking to backup an entire site, please continue to use site export - but we are planning on launching overhauls of backup/restore functionality as well as the ability to consolidate cloud sites more easily later this year!

If you have existing XML space exports that you took previously, you will still be able to import them into cloud using the same import spaces UI in site administration. We recommend though that you use the CSV format for future exports intended to be imported into cloud.

Please note, you will not be able to import CSV space exports into Confluence Server or Data Center, please continue to use the XML export format if you wish to do so.

[marc -Collabello--Phase Locked-]

Will the CSV export also handle content properties and macros?

[Steven Bao]

@marc -Collabello--Phase Locked- yes, it does

[Tomislav Tobijas _Koios_]

Nice. Thanks for the update!

[Tim Eddelbüttel]

CSV is more reliable over the XML?

I personally wouldn't agree if I look the the CSV experience of Jira when it comes to encoding, multiline content and control character issues.

But I will give it a try.

//EDIT: I see, the exported files looks like an export of the corresponding database tables and not something a big "preprared" CSV file.

[Dave Liao]

Thanks for releasing this! I'm always up for more reliable space exports and imports.

FYI, not seeing this in my Cloud instances yet, but it might be a release track delay. 😁

[Steven Bao]

Hey @Dave Liao - yes, we are progressively rolling this out and if you're on release tracks you will be one of the last to get the change.

[Danja Karenko]

Thank you! Does the CSV export contain drafts and unpublished changes? :)

[Matt Fleming]

This is great! So, to clarify... if I do an XML or a CSV backup, that'll back up all the images as well? 

[Steven Bao]

Yes, it will contain drafts and unpublished changes as well as images.

[morgan.wirth]

Images don't seem to be working in the import of the csv for me.  I just end up with a 'Creating preview...' message.

[Patrick]

Is there a way to automate this? 

[Suyash Jain {Appfire}]

Hi, I would like to know if this can be automated. We do not want to have complete cloud site backup as restoration is hard. Thanks