Export and Import Metadata Sets (v 3.0)

 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?

  1. Go to Space tools > Metadata > Export.
  2. Choose at least one space metadata set to export.
  3. Confirm with "Start export".

view of the export tab in the space administrationImage 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?

  1. Go to Space tools > Metadata > Import.
  2. Choose a .json file from your computer to import.
  3. 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?

  1. Open the .json file you exported and replace all instances of

    "spaceKey":"KEY_FROM_EXPORT_SPACE"

    with

    "spaceKey":"KEY_FROM_IMPORT_SPACE"
  2. Save the changes.
  3. Go to Space tools > Metadata > Import.
  4. Choose the .json file from 1. to import.
  5. 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



Back to Top