upstream-mattermost/docs/main/end-user-guide/project-management/migrate-to-boards.mdx

---
title: "Import, export, and migrate"
---
import useBaseUrl from '@docusaurus/useBaseUrl';

<PlanAvailability slug="entry-ent" />

## Import and export a board archive

If you’d like to back up your board or re-use it on another team or channel workspace, you can export it as an archive file, and then import the archive file in the team or channel workspace of your choosing. Exported and imported board archives include all card content such as properties, comments, descriptions, and image attachments.

To do this, select the options menu <img src={useBaseUrl('/img/ui/dots-horizontal_F01D8.svg')} alt="Use the More icon to access additional message options." className="theme-icon" /> to the left of the **New** button at the top of the board. Then select **Export board archive**. Download the archive file. Navigate to the team or channel workspace where you’d like to add the exported board. Select the Gear icon next to your profile picture, then choose **Import archive**. The board you exported will be added to this team or channel workspace.

The **Import archive** option will import the board to your current team. Use [board permissions](/end-user-guide/project-management/share-and-collaborate#board-permissions) to control access to your imported board. The previous `.focalboard` format will be deprecated in a future release, but will support importing until then. Currently, the import dialog looks for `.boardarchive`. Use **Select all files** to select `.focalboard` files to import.

## Export to CSV

To export a board into a CSV file, select the options menu <img src={useBaseUrl('/img/ui/dots-horizontal_F01D8.svg')} alt="Use the More icon to access additional message options." className="theme-icon" /> to the left of the **New** button at the top of the board. Then select **Export to CSV**.

## Import and export from other applications

You can import data from other tools to use with Boards.

## Import from Asana

This node app converts an Asana JSON archive into a `.boardarchive` file.

1.  Log into your Asana account.
2.  Select the drop-down menu next to the Asana board's name. Then select **Export/Print \> JSON**. This will create an archive file which you'll use in Boards.
3.  Save the file locally, e.g. to `asana.json`.
4.  Open a terminal window on your local machine and clone the focalboard repository to a local directory, e.g. to `focalboard`:

``` sh
git clone https://github.com/mattermost/focalboard focalboard
```

5.  Navigate to `focalboard/webapp`.
6.  Run `npm install`.
7.  Change directory to `focalboard/import/asana`.
8.  Run `npm install`.
9.  From within the same folder, run `npx ts-node importAsana.ts -i <asana.json> -o archive.boardarchive`. This generates the following data:

``` sh
asana macbook$ npx ts-node importAsana.ts -i ~/Downloads/asana.json -o archive.boardarchive
Board: 1:1 Meeting Agenda Test
Card: [READ ME] Instructions for using this project
Card: [EXAMPLE TASK] Feedback on design team presentation
Card: [EXAMPLE TASK] Finalize monthly staffing plan
Card: [EXAMPLE TASK] Review Q2 launch video outline
Card: [EXAMPLE TASK] Mentor a peer

Found 5 card(s).
Exported to archive.boardarchive
```

10. In Boards, open the board you want to use for the export.
11. Select **Settings \> Import archive** and select `archive.boardarchive`.
12. Select **Upload**.
13. Return to your board and confirm that your Asana data is now displaying.

If you don't see your Asana data, an the error should be displayed. You can also check log files for errors.

### Import scope

Currently, the script imports all cards from a single board, including their section (column) membership, names, and notes.

## Import from Notion

This node app converts a Notion CSV and markdown export into a `.boardarchive` file.

1.  From a Notion Board, open the **...** menu at the top right corner of the board.
2.  Select <code>Export</code> and pick <code>Markdown & CSV</code> as the export format.
3.  Save the generated file locally, and unzip the folder.
4.  Open a terminal window on your local machine and clone the focalboard repository to a local directory, e.g. to `focalboard`:

``` sh
git clone https://github.com/mattermost/focalboard focalboard
```

5.  Navigate to `focalboard/webapp`.
6.  Run `npm install`.
7.  Change directory to `focalboard/import/notion`.
8.  Run `npm install`.
9.  From within the same folder, run `npx ts-node importNotion.ts -i <path to the notion-export folder> -o archive.boardarchive`.
10. In Boards, open the board you want to use for the export.
11. Select **Settings \> Import archive** and select `archive.boardarchive`.
12. Select **Upload**.
13. Return to your board and confirm that your Notion data is now displaying.

### Import scope

Currently, the script imports all cards from a single board, including their properties and markdown content.

The Notion export format does not preserve property types, so the script currently imports all card properties as a Select type. You can change the type after importing into Focalboard.

## Import from Jira

This node app converts a Jira `.XML` export into a `.boardarchive` file.

1.  Open Jira advanced search, and search for all the items to export.
2.  Select **Export \> Export XML**.
3.  Save the generated file locally, e.g. to `jira_export.xml`.
4.  Open a terminal window on your local machine and clone the focalboard repository to a local directory, e.g. to `focalboard`:

``` sh
git clone https://github.com/mattermost/focalboard focalboard
```

5.  Navigate to `focalboard/webapp`.
6.  Run `npm install`.
7.  Change directory to `focalboard/import/jira`.
8.  Run `npm install`.
9.  From within the same folder, run `npx ts-node importJira.ts -i <path-to-jira.xml> -o archive.boardarchive`.
10. In Boards, open the board you want to use for the export.
11. Select **Settings \> Import archive** and select `archive.boardarchive`.
12. Select **Upload**.
13. Return to your board and confirm that your Jira data is now displaying.

### Import scope and known limitations

Currently, the script imports each item as a card into a single board. Note that Jira `.XML` export is limited to 1000 issues at a time.

Users are imported as Select properties, with the name of the user.

The following aren't currently imported:

- Custom properties
- Comments
- Embedded files

## Import from Trello

This node app converts a Trello `.json` archive into a `.boardarchive` file.

1.  From the Trello Board Menu, select **...Show Menu**.
2.  Select **More \> Print and Export \> Export to JSON**.
3.  Save the generated file locally, e.g. to `trello.json`.
4.  Open a terminal window on your local machine and clone the focalboard repository to a local directory, e.g. to `focalboard`:

``` sh
git clone https://github.com/mattermost/focalboard focalboard
```

5.  Navigate to `focalboard/webapp`.
6.  Run `npm install`.
7.  Change directory to `focalboard/import/trello`.
8.  Run `npm install`.
9.  From within the same folder, run `npx ts-node importTrello.ts -i <path-to-trello.json> -o archive.boardarchive`.
10. In Boards, open the board you want to use for the export.
11. Select **Settings \> Import archive** and select `archive.boardarchive`.
12. Select **Upload**.
13. Return to your board and confirm that your Trello data is now displaying.

### Import scope

Currently, the script imports all cards from a single board, including their list (column) membership, names, and descriptions.

## Import from Todoist

This node app converts a Todoist `.json` archive into a `.boardarchive` file.

1.  Visit the open source Todoist data export service at [https://darekkay.com/todoist-export/](https://darekkay.com/todoist-export/).
2.  From the **Options** menu, select **Export As \> JSON (all data)**.
3.  Uncheck the **Archived** option if checked.
4.  Select **Authorize and Backup**. This will take you to your Todoist account. Follow the instructions on screen.
5.  Note the name and location of the downloaded `.json` file.
6.  Open a terminal window on your local machine and clone the focalboard repository to a local directory, e.g. to `focalboard`:

``` sh
git clone https://github.com/mattermost/focalboard focalboard
```

7.  Navigate to `focalboard/webapp`.
8.  Run `npm install`.
9.  Change directory to `focalboard/import/todoist`.
10. Run `npm install`.
11. From within the same folder, run `npx ts-node importTodoist.ts -i <path-to-todoist.json> -o archive.boardarchive`.
12. In Boards, open the board you want to use for the export.
13. Select **Settings \> Import archive** and select `archive.boardarchive`.
14. Select **Upload**.
15. Return to your board and confirm that your Todoist data is now displaying.