> 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 Miro board into Smaply as a journey map by exporting it as an image.

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](https://helpdesk.smaply.app/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="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 > Miro</p></figcaption></figure>

<figure><img src="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-99026ecd876bb9cf972ddd46de5b7dd9e431f33e%2Fmigration-import-03-upload-step.png?alt=media" 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](https://helpdesk.smaply.app/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="https://helpdesk.smaply.app/migration/how-to-import-from-image.md">Import from image</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="https://helpdesk.smaply.app/migration/how-to-import-from-figma.md">Import from Figma</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="https://helpdesk.smaply.app/migration/how-to-import-from-powerpoint.md">Import from PowerPoint</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="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-miro.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.
