Export and Import Metadata Sets (v 3.0)
- Almuth Boehme [Communardo]
- Duy N.
SINCE VERSION 3.0
You need admin permissions for this step, be they Space Admin, Confluence Admin or System Admin permissions.
What kind of data can I export/import?
- Space metadata sets (set and field structure)
- Metadata values of chosen sets
It is not possible to export or import
- global metadata sets
- metadata sets with space metadata fields and global metadata fields mixed
How do I export metadata?
- Go to Space tools > Metadata > Export.
- Choose at least one space metadata set to export.
- Confirm with "Start export".
Image 1: Metadata Export Tab in the Space Administration
This export will include the chosen space metadata sets and fields.
Optionally, you can check "Export metadata values". The metadata values added to individual pages/blog posts in this space will only be exported, if you check this option.
When the export has been created successfully, click the "Download export" button to download the created .json file directly in your browser.
Image 2: Metadata Export Progress Bar
To leave this screen and start another export, confirm with "Done".
How do I import metadata between spaces with the same space key?
- Go to Space tools > Metadata > Import.
- Choose a .json file from your computer to import.
- Confirm with "Start import".
Please refer to the Troubleshooting section below in case of errors.
How do I import metadata from a space with a different space key?
Open the .json file you exported and replace all instances of
"spaceKey":"KEY_FROM_EXPORT_SPACE"
with
"spaceKey":"KEY_FROM_IMPORT_SPACE"
- Save the changes.
- Go to Space tools > Metadata > Import.
- Choose the .json file from 1. to import.
- Confirm with "Start import".
Please make sure to only change the space keys. We do not offer support in case other changes have a detrimental effect on data integrity or functionality of your system.
Please refer to the Troubleshooting section below in case of errors.
Troubleshooting
If you run into problems, please refer to the below articles
- Import Fails: Some of the metadata fields and sets already exist
- Import Fails: It is not possible to import metadata from space A into space B
- Export: No metadata defined