> For the complete documentation index, see [llms.txt](https://helpdesk.smaply.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpdesk.smaply.app/migration/how-to-import-from-json.md).

# How to import from JSON

Re-import a journey map you exported from Smaply as JSON, to move it between workspaces or bring back a saved copy.

The JSON source brings back a journey map you previously exported from Smaply as a JSON file. It is a Smaply-to-Smaply round-trip: export a map to a `.json` file from one workspace, then import that file into another. Use it to move a map between workspaces or accounts, or to keep an offline copy you can restore later.

{% hint style="info" icon="tag" %}
Importing journey maps is available on the Repository plan and above.
{% endhint %}

{% hint style="warning" icon="list-check" %}

#### Prerequisites

You need Editor access in the destination workspace, since importing creates a new journey map.
{% endhint %}

JSON import is not an AI reconstruction. It restores the map structure from a file Smaply created, so the result matches the original rather than a rebuilt approximation. It only accepts `.json` files exported from Smaply, not JSON from other tools.

#### How to export a journey map as JSON

Start in the map you want to move or back up.

{% stepper %}
{% step %}
**Open the journey map**

Open the journey map you want to export from its workspace.
{% endstep %}

{% step %}
**Choose Export as JSON**

Click the three-dot menu next to the map title and choose **Export as JSON**. Smaply downloads a `.json` file of the map to your computer.

<figure><img src="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-8dca92e1af095e26c7a15ee8696628288403e731%2Fmigration-import-07-export-as-json-menu.png?alt=media" alt="The journey map title menu open, showing Create a copy, Import from Excel, Export as JSON, and Archive."><figcaption><p>Journey map title menu > Export as JSON</p></figcaption></figure>
{% endstep %}
{% endstepper %}

#### How to import the JSON file

Switch to the workspace where you want the map to land.

{% stepper %}
{% step %}
**Open the import flow**

In the destination workspace, open **Journey maps** and click **Import** in the toolbar, next to **Create journey map**.

<figure><img src="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-2d14b80e30e415fd5c667ec5fe5a173afc5877fb%2Fmigration-import-01-list-import-button.png?alt=media" alt="A journey maps list with a toolbar in the top right. The toolbar has search and filter icons, an Import button, and a Create journey map button."><figcaption><p>Journey maps > Import</p></figcaption></figure>
{% endstep %}

{% step %}
**Choose JSON and click Continue**

In the **Select import source** modal, choose **JSON** (the "JSON import" card), then click **Continue**.

<figure><img src="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-76c2d398130be10e89b952cf893d0c7254525372%2Fmigration-import-02-source-picker.png?alt=media" alt="The Select import source modal showing six cards: Figma, Miro, Image or screenshot, and Powerpoint marked with an AI icon, plus an Excel card labelled .xlsx spreadsheet and a JSON card labelled JSON import. Cancel and Continue buttons sit at the bottom."><figcaption><p>Select import source</p></figcaption></figure>
{% endstep %}

{% step %}
**Upload the .json file**

On the **Upload a json file** step, drag your file into the dropzone or click **Upload**. Only `.json` files exported from Smaply are supported. Then click **Import**. The map opens in the destination workspace.

<figure><img src="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-6177ef4eb57de5147778443194c643e695ee6ecb%2Fmigration-import-06-json-upload.png?alt=media" alt="The Upload a json file step with a dropzone reading Upload or drop json file and a note that only .json files are supported. An Import button sits at the bottom right."><figcaption><p>Upload a json file</p></figcaption></figure>
{% endstep %}
{% endstepper %}

#### Related topics

<table data-column-title-hidden data-view="cards"><thead><tr><th>Article</th><th>What it covers</th><th data-hidden data-card-target data-type="content-ref">Target</th></tr></thead><tbody><tr><td><strong>How to import from image</strong></td><td>Upload a screenshot of a map and let Smaply AI rebuild it.</td><td><a href="https://helpdesk.smaply.app/migration/how-to-import-from-image.md">Import from image</a></td></tr><tr><td><strong>How to import from Excel</strong></td><td>Import a journey map from an Excel or CSV spreadsheet.</td><td><a href="https://helpdesk.smaply.app/migration/how-to-import-from-excel.md">Import from Excel</a></td></tr><tr><td><strong>How to copy assets across workspaces</strong></td><td>Copy a journey map to another workspace without exporting.</td><td><a href="https://helpdesk.smaply.app/account-and-team/workspaces/how-to-copy-assets-across-workspaces.md">Copy assets across workspaces</a></td></tr><tr><td><strong>How to create a journey map</strong></td><td>Start a new journey map from scratch, a template, or AI.</td><td><a href="https://helpdesk.smaply.app/journey-maps/how-to-create-a-journey-map.md">Create a journey map</a></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://helpdesk.smaply.app/migration/how-to-import-from-json.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
