# Welcome

Welcome to the official documentation for the Mind Map Downloader application for Miro. This library serves as a comprehensive resource for users, offering in-depth information on the functionality, export formats, and integration processes associated with the app. We will also use this space to log details of each app update.

For any questions about the material in this documentation or about the app itself please reach out to us. We are available at the following email addresses:

> <info@miromindmap.com>, <info@csvgetter.com>


# How to

A helpful video of how to use the app

{% embed url="<https://www.loom.com/share/c7e7888a5fda45da996988fcf9b8c732?sid=ca956c57-9c9c-445b-ad79-37da0677d03b>" %}
How to
{% endembed %}


# 3.0.0 (Latest)

Can export multiple widget types

{% embed url="<https://www.loom.com/share/5cb51466775a4007b7957f071328b715?sid=8cd254c0-12c1-42c8-a1ce-f89b221540fe>" %}


# 2.2.2

Search your Mind Map!

{% embed url="<https://www.loom.com/share/5679ba82c4b04287b5f5771859a45405?sid=e61552e6-7880-4a77-868f-d4fd696aff5b>" %}
Search your Mind Map
{% endembed %}


# 2.2.1

Set Mind Map direction and download multiple mind maps

{% embed url="<https://www.loom.com/share/6e9b76c3e251402082e21723f9fbc43c?sid=c7753ac1-4cd9-4780-a5d2-fa136acd62a2>" %}

**Updates include:**

* Multiple Mind Maps can be downloaded in the same data structure.
* You can now set the direction of your Mind Map

When you import a Mind Map, you can set the direction of the Mind Map. [See here.](/notes/direction)


# 2.2.0

API Endpoints

**Updates include:**

* Turn your Mind Map Data into an API endpoint.

Watch the demo:

{% embed url="<https://www.loom.com/share/3f1cf3d366dd48228c81c322515e7243?sid=8c002701-dda6-403d-8636-2580d5e230de>" %}
Watch the Demo
{% endembed %}

You can now turn your Miro Mind Map into a live data API.&#x20;

<div align="center"><figure><img src="/files/yFLM8vfOOjaOlVdbmr57" alt="" width="563"><figcaption><p>Create + Update endpoints in Miro</p></figcaption></figure></div>

<figure><img src="/files/DvIB8cKebtGXDOjnagp1" alt="" width="563"><figcaption><p>Access the data structure in your applications</p></figcaption></figure>

### Read about the new feature [here.](/export-types/api)


# 2.1.2

OPML with Attributes bug fixes

* OPML with attributes upload fixed. There was an error parsing new Mindmap properties added by Miro.
* Fixed a bug with file upload. Editing and reuploading a file would cause the Import function to fail. This has been rectified.

For feature requests, email either <info@miromindmap.com> or <info@csvgetter.com>.


# 2.1.1

Links now included in CSV files

Links are now processed into exports. Full example [here](/notes/links).


# CSV

Export your Mind Map data as CSV Data

### Example 1

#### Example Mind Map

<figure><img src="/files/Ipf3OXMqKV7pnX550LD6" alt=""><figcaption><p>A screenshot of a Mind Map in Miro</p></figcaption></figure>

#### CSV Export

```csv
0,1,2
Example Mind Map,Topic,Definition
Example Mind Map,Topic,Purpose
Example Mind Map,Topic,Applications
Example Mind Map,Structure,Main Idea
Example Mind Map,Structure,Subtopics
Example Mind Map,Structure,Details
Example Mind Map,Tools,Digital Tools
Example Mind Map,Tools,Paper and Pen
Example Mind Map,Tools,Templates
Example Mind Map,Process,Brainstorming
Example Mind Map,Process,Organizing Ideas
Example Mind Map,Process,Reviewing
Example Mind Map,Examples,Personal Projects
Example Mind Map,Examples,Academic Use
Example Mind Map,Examples,Business Planning
Example Mind Map,Benefits,Visual Learning
Example Mind Map,Benefits,Enhanced Memory
Example Mind Map,Benefits,Improved Organization
Example Mind Map,Considerations,Clarity
Example Mind Map,Considerations,Simplicity
Example Mind Map,Considerations,Flexibility
```

<figure><img src="/files/t4Q8w4iwuZxEHfTe1NYp" alt="" width="563"><figcaption><p>The CSV file when opened in Excel</p></figcaption></figure>

### Example 2

#### Example Mind Map

<div><figure><img src="/files/OlcafEks0a8lszEBw52r" alt=""><figcaption><p>Including a Link inline</p></figcaption></figure> <figure><img src="/files/Etmw8mQjGTr2bqqAqJSc" alt=""><figcaption><p>Using Link To to add links</p></figcaption></figure></div>

#### Export Result

```csv
0,1,2
Simple Mind Map,Links,Link 1 (https://www.csvgetter.com/)
Simple Mind Map,Links,Link 2 (https://www.csvgetter.com/blog)
Simple Mind Map,Links, Link 3 (https://www.csvgetter.com/info)
```

<figure><img src="/files/xjrnjA5JIF9yB7bLLFki" alt="" width="563"><figcaption><p>CSV Data with Links in Excel</p></figcaption></figure>


# OPML

Export your Mind Map data as OPML data

### Example 1

#### Example Mind Map

<figure><img src="/files/mzl6z2XGALrIDzHEmXrY" alt=""><figcaption><p>A screenshot of a Mind Map in Miro</p></figcaption></figure>

#### OPML Export

```xml
<?xml version="1.0" encoding="UTF-8"?>
<opml version="2.0">
  <head>
    <title>mindmap.opml</title>
    <dateCreated>Wed Oct 30 2024 12:53:23 GMT+0000 (Greenwich Mean Time)</dateCreated>
  </head>
  <body>
    <outline text="Simple map">
      <outline text="node d">
        <outline text="4"/>
      </outline>
      <outline text="node c">
        <outline text="3"/>
      </outline>
      <outline text="node b">
        <outline text="2"/>
      </outline>
      <outline text="node a">
        <outline text="1"/>
      </outline>
    </outline>
  </body>
</opml>
```

OPML is compatible with other Mind mapping software such as Mind Manager.


# OPML with Attributes

Branch positions and other properties are remembered in the OPML when importing and exporting the data. More properties to be included soon

### Example 1

#### Example Mind Map

<figure><img src="/files/ThvfBkZAOxxbqEe6TGq7" alt=""><figcaption><p>A screenshot of a Mind Map in Miro with branches of different colour and position</p></figcaption></figure>

#### OPML Export

```xml
<?xml version="1.0" encoding="UTF-8"?>
<opml version="2.0">
  <head>
    <title>mindmap.opml</title>
    <dateCreated>Thu Oct 31 2024 15:11:07 GMT+0000 (Greenwich Mean Time)</dateCreated>
  </head>
  <body>
    <outline type="shape" text="Miro Mind Map" shape="pill" style_fontSize="14" style_color="#7a28ff" style_fillOpacity="0" style_borderStyle="normal">
      <outline type="text" text="This is an end branch" direction="end" style_fontSize="14"/>
      <outline type="shape" text="This is a pill node" shape="pill" direction="end" style_fontSize="14" style_color="#b736ff" style_fillOpacity="0.1" style_borderStyle="normal"/>
      <outline type="text" text="This is a start branch" direction="start" style_fontSize="14"/>
    </outline>
  </body>
</opml>
```

The OPML properties are parsed by Mind Map Downloader when the data is uploaded again:

<figure><img src="/files/gqH1XnVF96UhvUEdaJgv" alt=""><figcaption><p>OPML file with attributes that are remembered for re-upload</p></figcaption></figure>


# JSON

Export your mind map data as JSON

### Example 1

#### Example Mind Map

<figure><img src="/files/FSC80meDMNZpeiRicnVu" alt=""><figcaption><p>Details about a vehicle</p></figcaption></figure>

#### JSON Export

```json
{
  "text": "Vehicle Details",
  "links": [],
  "children": [
    {
      "text": "Milage",
      "links": [],
      "children": [
        {
          "text": "37,201",
          "links": [],
          "children": []
        }
      ]
    },
    {
      "text": "Year",
      "links": [],
      "children": [
        {
          "text": "2015",
          "links": [],
          "children": []
        }
      ]
    },
    {
      "text": "Model",
      "links": [],
      "children": [
        {
          "text": "Vauxhall Corsa SE",
          "links": [],
          "children": []
        }
      ]
    },
    {
      "text": "Colour",
      "links": [],
      "children": [
        {
          "text": "Black",
          "links": [],
          "children": []
        }
      ]
    }
  ]
}
```

### Example 2

#### Example Mind Map

<figure><img src="/files/P5Q6bPGqe4EJhvyVfSgL" alt=""><figcaption><p>Vauxhall Corsa Node has a link attached</p></figcaption></figure>

```json
{
  "text": "Vehicle Details",
  "links": [],
  "children": [
    {
      "text": "Model",
      "links": [],
      "children": [
        {
          "text": "Vauxhall Corsa SE",
          "links": [
            "https://en.wikipedia.org/?title=Vauxhall_Corsa&amp;redirect=no"
          ],
          "children": []
        }
      ]
    }
  ]
}
```


# API

Turn your Miro Mind Map into a live API endpoint

The new API feature allows you to generate a direct CSV download URL from your Miro Mind Map data. This URL can act as an API endpoint, enabling seamless integration with other tools and workflows, from updating databases to triggering automated reports. Follow the steps below to start using this feature effectively.

### Overview

With the API feature, you can create a live CSV download URL for your Mind Map data. This can be a new URL or an update to an existing one if your Mind Map changes. This live link makes it easier to share, download, or directly integrate Mind Map data into other systems.

{% embed url="<https://www.loom.com/share/3f1cf3d366dd48228c81c322515e7243?sid=8c002701-dda6-403d-8636-2580d5e230de>" %}

### Selecting the API File Type

1. From the **File Type** dropdown in Mind Map Downloader, select **API**.
2. You’ll see options to either **Create a New Endpoint** or **Update an Existing Endpoint**.

<figure><img src="/files/yFLM8vfOOjaOlVdbmr57" alt="" width="375"><figcaption><p>Create or Update API endpoints with the 'API' feature.</p></figcaption></figure>

### Creating a New API Endpoint

To set up a new endpoint:

1. Select **API** as your file type in the Mind Map Downloader.
2. Choose **Create New Endpoint**.
3. In the **Endpoint Name** field, enter a unique name for your endpoint.
   * Use all lowercase letters, and replace spaces with hyphens (e.g., `my-mindmap-endpoint`).
   * Special characters are not allowed.
4. Select the center node of your Mind Map as usual with Mind Map Downloader.
5. Click **Load Export**.
6. Click **Create API Endpoint**.

### Updating an Existing API Endpoint

To update an existing endpoint:

1. Select **API** as your file type in the Mind Map Downloader.
2. Choose **Update Existing Endpoint**.
3. From the dropdown, select the endpoint you want to update.
4. Select the center node of your Mind Map.
5. Click **Load Export**.
6. Click **Update API Endpoint**.

### Using the API Endpoint

Your API endpoint URLs follow this format:

```uri
https://api.miromindmap/<unique-user-id>/<endpoint-name>
```

When you create or update an endpoint, a confirmation alert will display the new URL.

<figure><img src="/files/Vv9fY8VsNh5qKgQOFCrY" alt="" width="375"><figcaption><p>An alert will display your API endpoint</p></figcaption></figure>

You can also view any existing URL by selecting **Update Existing Endpoint** and choosing your endpoint from the dropdown, then clicking **Show API Endpoint URL**.

<figure><img src="/files/FA2zcfTjfNnxzMF457DF" alt="" width="183"><figcaption></figcaption></figure>

You can test your URL in a browser or with a tool like [Postman](https://www.postman.com/).

<figure><img src="/files/DvIB8cKebtGXDOjnagp1" alt=""><figcaption></figcaption></figure>

### Important Notes

* **Automatic Formatting**: The **Endpoint Name** field automatically converts input to lowercase, replaces spaces with hyphens, and removes special characters.
* **Unique Name Requirement**: If the entered name already exists, the feature will recognize it as an update rather than creating a new endpoint.
* **Security**: Each API endpoint URL includes a unique identifier tied to your Miro account. This ensures the security of your data.
* **Storage:** The API feature will require your Mind Map data to be stored in our systems. This is done to an industry standard with the latest end-to-end encryption.

If you have any questions about these API endpoints, please contact our support team.


# Links

Some notes on how we process link data

There are two ways to include a link in a mind map node.

#### Method A

Creating a link by highlighting text:

<figure><img src="/files/FKN8QfSQBeadMWteEEhu" alt="" width="375"><figcaption></figcaption></figure>

#### Method B

Using Link tto:

<div><figure><img src="/files/IHXfiH491EZhOuS33FOz" alt="" width="375"><figcaption><p>Use Link to when the node is selected</p></figcaption></figure> <figure><img src="/files/l8UPtPHB6UifbxepkihM" alt="" width="375"><figcaption><p>Adding a link with link to</p></figcaption></figure></div>

Both ways of including links will now appear in the export. Links will appear in brackets.

<figure><img src="/files/PaABueZtMg4wu1I2R3O1" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="/files/AvgF9LaFypStuP4PPlcb" alt="" width="312"><figcaption></figcaption></figure>


# Connectors

We are working on adding this - but how should they be included in the data?

<figure><img src="/files/SkHgdg1ael2QYgJgcB4A" alt="" width="563"><figcaption></figcaption></figure>

We want to include connector information to our Mind Map exports, but we need to understand how best to include the connector in the data export.

#### Suggestions so far:

#### Example A

<figure><img src="/files/RsrNOHDS4TfV3M2CgtQN" alt="" width="322"><figcaption></figcaption></figure>

#### Suggestion A.1 (CSV)

```csv
0,1,2
Example,A,Example.A>Example.B.BA,Example.A>Example.B.BB
Example,B,BA,Example.B>Example.A
Example,B,BB
```

#### Suggestion A.2 (CSV

```csv
Example,A
Example,B,BA
Example,B,BB
Example.A>Example.B.BA
Example.A>Example.B.BB
Example.B>Example.A
```


# Direction

Setting the direction when importing a Mind Map

You can set the direction using the select box when importing a Mind Map.

<figure><img src="/files/wvSudhlEOYg12j7k4pRd" alt="" width="182"><figcaption></figcaption></figure>

## Examples

### Centered

<figure><img src="/files/Xb3Gq0ugk8FlPnAeQ6v7" alt="" width="375"><figcaption></figcaption></figure>

### Left-Sided

<figure><img src="/files/9wF44zcv7JwVRo6gn1Pe" alt="" width="188"><figcaption></figcaption></figure>

### Right-Sided

<figure><img src="/files/yKXehaIJktEOT6HFnzwM" alt="" width="188"><figcaption></figcaption></figure>


# Facilitator School Demo

We were featured in a video by Facilitator School, you can watch it here

{% embed url="<https://www.youtube.com/watch?v=1k5BQGO3t5I>" %}


# Find your UID

You can find your UID on the settings/pricing page.

<figure><img src="/files/C5WkqyJC8s2HkwlgE6YU" alt="" width="357"><figcaption></figcaption></figure>


# Import Template

Download our import template here

CSV Import

{% file src="/files/4IlNHk0XYuAjJADRD6Gj" %}
Download our import file
{% endfile %}

OPML Import

{% file src="/files/yamSvOmsHtZUNvY6CN9p" %}


# Pricing

We offer 5 imports/exports for free. We will then invite you to join one of our plans.

### **Lite Plan**

The Lite Plan is **$4.99** per month and unlocks all features of the Mind Map Downloader app. With the Lite Plan, you get 25 exports per month.

### **Standard Plan**

The Standard Plan is **$9.99** per month and unlocks all features of the Mind Map Downloader app. With the Standard Plan, you get 50 exports per month.

### **Pro Plan**

The Pro Plan is **$19.99** per month and unlocks all features of the Mind Map Downloader app. With the Pro Plan, you get 100 exports per month.

### How do I purchase a plan?

1. Open the Mind Map Downloader app in Miro.
2. Press the settings icon to access plans.
3. Select a plan and complete the checkout.
4. Refresh Mind Map Downloader in Miro.


# License Keys

Purchase a license key for your team or organisation.

If you would like to enable several Mind Map downloader users under one plan, you can purchase a license key from us.&#x20;

Your team, colleagues, or clients can unlock full Mind Map Downloader features by entering your license key in the Mind Map Downloader app in the settings page.&#x20;

Get in touch with us at [info@miromindmap.com](mailto:info@miromindmap.com?subject=MMD%20License%20Key%20request) to discuss your license key plan.


# Cancelling your subscription

It's easy to cancel your Mind Map Downloader Subscription

Note: Mind Map Downloader is a seperate entity to Miro and your Mind Map Downloader subscription is not linked to your Miro account.

#### Cancelling your subscription

Head to the Mind map Downloader app in Miro.

<figure><img src="/files/81WqJjPQwVQ52ackjnEz" alt="" width="375"><figcaption></figcaption></figure>

Press the settings icon (the gear) to open the settings screen.

<figure><img src="/files/SVp0cdJnliJ0RsYYWmOK" alt=""><figcaption></figcaption></figure>

Press Cancel Plan and follow the instructions

<figure><img src="/files/lgzwStGCH9q08he0S0Rb" alt=""><figcaption></figcaption></figure>