> 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-miro.md).

# How to import from Miro

Bring a journey map you built in Miro into Smaply, where AI rebuilds it as an editable journey map.

Smaply imports an image and AI turns it into a journey map, so the job is to get a clean image out of Miro first, then upload it. The import itself is the same for every source. This page covers the Miro export; [How to import from image](/migration/how-to-import-from-image.md) covers the upload flow and what to expect.

#### How to export your Miro board as an image

Export the single frame that holds your journey map, not the whole canvas. A tightly cropped frame at high resolution gives the AI the clearest text to read.

{% stepper %}
{% step %}
**Quick route: Copy as image**

Right-click the frame (or the objects you want) and choose **Copy as image**. Miro copies the selection to your clipboard as a PNG. Paste it into Preview, Paint, or any image editor and save it as a `.png`. This is the cleanest way to get one frame out, and PNG keeps text crispest for the AI.
{% endstep %}

{% step %}
**Or save a selected area as an image**

In the top-left corner, open the three-dots (**...**) menu, go to **Board**, and choose **Save as image**. Drag to select the area around your journey map, pick an image size, and click **Export**. Raster sizes (Small, Medium, Large) download as JPG; the Vector option produces SVG or PDF.
{% endstep %}

{% step %}
**Choose a Smaply-friendly format**

Smaply accepts `.png`, `.jpg`, `.jpeg`, `.svg`, and `.webp`, but not PDF. From the **Save as image** menu, choose a raster size for JPG, or pick the Vector option and choose **SVG** rather than PDF. JPG or PNG at the largest size is the safe default; SVG is sharpest for maps that are mostly text and shapes.
{% endstep %}
{% endstepper %}

{% hint style="success" icon="lightbulb" %}

#### **Tip: Export at the largest size your plan allows**

The bigger and sharper the image, the more reliably the AI reads your card text. Free Miro plans export at Small size only, which can be too low-resolution for dense maps. If **Save as image** is greyed out, the board owner may have turned off exporting.
{% endhint %}

If your journey map fits on one screen at a readable zoom, an operating-system screenshot works too: zoom the frame to fit, hide side panels, and capture tightly around the map (Cmd+Shift+4 on macOS, Win+Shift+S on Windows). For maps wider than the viewport, use the real export so nothing is cut off.

#### Import it into Smaply

In a workspace, open **Journey maps** and click **Import**. In the **Select import source** modal, choose the **Miro** card, click **Continue**, then upload your exported image and click **Import**.

<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 > Miro</p></figcaption></figure>

<figure><img src="/files/xwaFLWCP2vT0T1Y131wW" alt="The Add an image or screenshot step with a dropzone for uploading or pasting an image, a note listing supported formats, and an Import button."><figcaption><p>Add an image or screenshot</p></figcaption></figure>

For the full flow and what to expect, see [How to import from image](/migration/how-to-import-from-image.md).

{% hint style="info" %}
The AI reconstruction is a starting point, not a structure-preserving copy. Review the generated map and adjust lanes, cards, and text before relying on it.
{% endhint %}

#### 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>The full upload-and-rebuild flow shared by every import source.</td><td><a href="/pages/gUbzvZgq0NRwr87aVZTt">/pages/gUbzvZgq0NRwr87aVZTt</a></td></tr><tr><td><strong>How to import from Figma</strong></td><td>Export a Figma frame as an image, then import it into Smaply.</td><td><a href="/pages/vSEFXkqD0FJIZlCZRAs8">/pages/vSEFXkqD0FJIZlCZRAs8</a></td></tr><tr><td><strong>How to import from PowerPoint</strong></td><td>Save a slide as an image, then import it into Smaply.</td><td><a href="/pages/anEf5fPCdJUNFcwRrmwi">/pages/anEf5fPCdJUNFcwRrmwi</a></td></tr><tr><td><strong>How to create a journey map</strong></td><td>Start a new map with Smaply AI, from scratch, or from a template.</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-miro.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.