Skip to main content
You can export your entire workspace as a downloadable JSON archive. Exports are useful for taking backups, migrating to another Marble workspace, or piping your content into another tool.

​
What’s in an export

Each export is a single .zip archive containing one JSON file per resource plus a manifest:
Exports include media metadata — not the underlying media files. Media URLs in media.json continue to point to the originally hosted files.

​
Starting an export

  1. Open Settings → Data in your workspace.
  2. Find the Export Workspace Data section.
  3. Click Start Export.
Marble queues the export and starts building the archive in the background. You can leave the page while it runs — the status updates automatically when you return.

​
Job lifecycle

Each export moves through a few states:

​
Downloading the archive

Once a job is ready, a Download button appears next to it in the export list. The most recent three exports are shown, and any finished export remains downloadable for 24 hours. After that window the file is deleted and the job is marked expired — start a new export to get a fresh copy.

​
Email notification

When an export finishes, Marble sends an “Your export is ready” email containing the download link and its expiry time. The email goes to:
  • The workspace member who started the export.
  • All workspace owners.
This means owners always have a record of completed exports, even if someone else triggered them.
Use exports to back up your workspace, hand off content to another team, or seed a new Marble workspace with your existing data. The JSON layout is stable across exports (schemaVersion: 1), so you can safely script against it.