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

# How to import from UXPressia

Export a UXPressia journey map as CSV or PNG, then pick the Smaply import source that matches the file.

Bring a journey map you built in UXPressia into Smaply as an editable journey map.

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

Export the map from UXPressia as a CSV, then import it in Smaply with the **Excel** source. A CSV keeps your lanes and steps as a grid, so Smaply reads the structure directly instead of rebuilding it from a picture. If your UXPressia plan doesn't offer CSV, export a PNG and use **Image or screenshot** instead.

This page covers the UXPressia export and which import source to pick. [How to import from Excel](/migration/how-to-import-from-excel.md) and [How to import from image](/migration/how-to-import-from-image.md) cover the upload flow itself.

#### How to export your journey map from UXPressia

{% stepper %}
{% step %}
**Open the map and click Export**

Open the journey map you want to move, then click **Export** in the top bar above the map editor. A pop-up opens where you pick a format.
{% endstep %}

{% step %}
**Pick CSV, or PNG if CSV isn't available**

Pick **CSV** to keep your lanes and steps as rows and columns. Pick **PNG** if CSV isn't offered on your plan, or if the CSV doesn't carry something you need to keep.
{% endstep %}
{% endstepper %}

{% hint style="info" icon="tag" %}
CSV, PDF, and PPTX export require a paid UXPressia plan. PNG export is available to free users, and free-plan exports carry a watermark.
{% endhint %}

Where each format lands in Smaply:

| UXPressia export | Smaply import source                               | What you get                                                                                                 |
| ---------------- | -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| **CSV**          | **Excel**                                          | A direct parse of your rows and columns, with no AI step.                                                    |
| **PNG**          | **Image or screenshot**                            | An AI reconstruction of the map from the picture.                                                            |
| **PPTX**         | **Powerpoint**, after saving the slide as an image | An AI reconstruction of the map from the picture.                                                            |
| **PDF**          | <i class="fa-xmark">:xmark:</i> Not accepted       | Nothing. Smaply's image import takes .svg, .png, .jpg, .jpeg, and .webp only, so export again as CSV or PNG. |

[How to import from PowerPoint](/migration/how-to-import-from-powerpoint.md) covers the slide-to-image route.

#### Import your UXPressia file into Smaply

In a 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>

There is no UXPressia card in the **Select import source** modal. Pick the card that matches the file you exported, 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%2Frn-2026-06-importer-excel-json.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>

* **For a CSV** - Choose **Excel**, the ".xlsx spreadsheet" card. The **Upload an excel file** step accepts .xlsx, .xls, and .csv, so a CSV goes in as it is. See [How to import from Excel](/migration/how-to-import-from-excel.md) for the full flow.
* **For a PNG** - Choose **Image or screenshot**, then upload the file and click **Import**. See [How to import from image](/migration/how-to-import-from-image.md) for the full flow and what to expect.

{% 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 %}

#### Check the mapping options against your UXPressia CSV

The **Upload an excel file** step has three options below the dropzone. All three are on by default:

* **First row is stage lane** - Creates a stage lane from the first row of data.
* **First column is lane names** - Uses the values in the first column as lane names.
* **Exclude empty lanes** - Skips lanes that have no content.

<figure><img src="https://1197101183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2For99xDEElfps9uMDY60K%2Fuploads%2Fgit-blob-7f179be87a5e9dc99d488d6b196e34ff0f8af170%2Frn-2026-06-importer-excel.png?alt=media" alt="The Upload an excel file step with a dropzone reading Upload or drop excel file and a note that supported files are .xlsx, .xls, and .csv. Below the dropzone are three checked options: First row is stage lane, First column is lane names, and Exclude empty lanes. An Import button sits at the bottom right."><figcaption><p>Upload an excel file</p></figcaption></figure>

A UXPressia CSV comes out grid-shaped, with lanes as rows and steps as columns, which is the layout these options expect. Open the file in a spreadsheet app before you upload it and check two things: whether the top row holds your stage names, and whether the left column holds your lane names. If the top row holds content instead of stage names, turn off **First row is stage lane**. If the left column holds content instead of lane names, turn off **First column is lane names**. Smaply then keeps the value as a card rather than a heading.

#### 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 Excel</strong></td><td>The full upload flow for a CSV or spreadsheet file.</td><td><a href="/migration/how-to-import-from-excel.md">Import from Excel</a></td></tr><tr><td><strong>How to import from image</strong></td><td>The full upload-and-rebuild flow shared by every image source.</td><td><a href="/migration/how-to-import-from-image.md">Import from image</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="/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="/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 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-uxpressia.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.
