# Open a file or a chart link

> Open a RelationMap JSON file with the Open button, by dropping it on the canvas, or by pasting the JSON. Opening replaces the chart on screen, and you can undo it.

RelationMap opens its own JSON files: the ones you get from **Export → JSON Data**, and ones written by an AI or a script in the [RelationMap format](https://relationmap.io/docs/data-format/).

## Three ways to open a file

- **Open button.** Open the menu and press **Open** in the top row, next to My Works and Export. Pick a `.json` file.
- **Drag and drop.** Drag the `.json` file onto the canvas. "Drop to open" appears; let go.
- **On an empty canvas**, the welcome text has an "open a JSON file" link. On a phone or tablet it is the "Or open a JSON file" button.

## Paste JSON instead

If you have the JSON as text, for example from an AI chat, open the menu, press **Edit as text**, paste it into the box and press **Apply**. The line under the box tells you what it found before anything changes. Details: [Make a chart with AI](https://relationmap.io/docs/ai/).

## What happens to the chart on screen

Opening a file **replaces** the chart you have open. If there is anything on the canvas, the editor asks "Replace the current map with this file?" first.

After it opens, a message with **Undo** appears at the bottom for a few seconds. Press it to get your previous chart back.

If the file can't be opened, you see "Could not open this file" with the reason, and your chart is not changed.

To keep what you have, save it to the cloud or export it as JSON before opening another file. See [Where your chart is saved](https://relationmap.io/docs/saving/).

## Open a chart from a link

- A link to a saved chart, `relationmap.io/map/<name>`, opens it for viewing. Press **Open in Editor** on that page: if the chart isn't yours, the editor offers to fork it into your own copy.
- A link that starts with `relationmap.io/edit/#data=` carries the whole chart inside the link. These are made by AI tools and scripts; see [Editor links](https://relationmap.io/docs/url-parameters/).

## What can't be opened

- Only RelationMap JSON. Spreadsheets (CSV, Excel), images of a chart and files from other diagram tools can't be opened.
- A list of names in plain text isn't a file to open: paste it with **Edit as text**, or drag the lines onto the canvas. See [Add many characters at once](https://relationmap.io/docs/add-many-characters/).

---

Web page: https://relationmap.io/docs/open-a-file/ · Updated 2026-11-15 · All docs: https://relationmap.io/llms.txt
