> 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

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="/files/ch8Zl9uduyUXIRHRT0Xn" 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="/files/yD3CwPqW3509FPZnMrt4" 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="/files/1w8hrjyqN7RWl0zpgZz6" 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="/files/vsom0xmaOExuIJ8UvxKy" 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="/pages/gUbzvZgq0NRwr87aVZTt">/pages/gUbzvZgq0NRwr87aVZTt</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="/pages/91FcKopj8LOEVkalDbfx">/pages/91FcKopj8LOEVkalDbfx</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="/pages/wTx8bqQ9c2foJOedyfim">/pages/wTx8bqQ9c2foJOedyfim</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="/pages/LfyJzQKJ0Sv9rMnQYKEQ">/pages/LfyJzQKJ0Sv9rMnQYKEQ</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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.