---
title: Import from Notion
description: Move your Notion workspace, with its folders, links and images, into a Space.
slug: /docs/import-notion
updatedAt: 2026-11-18
---

Export your whole Notion workspace as a ZIP, then use **Import ZIP** in Display. Each page becomes a document in a new folder. Subpages become subfolders, and links between pages and images point to the imported files.

Import ZIP is in the Spaces dashboard on Solo and higher plans.

## 1. Export from Notion

Export the whole workspace:

1. In Notion, open **Settings**, then **General**.
2. Select **Export all workspace content**.
3. For **Export format**, choose **HTML**.
4. Turn on **Create folders for subpages**.
5. Select **Export**. Notion sends a link to the ZIP by email.

Only a workspace owner can export the whole workspace.

To import only part of a workspace, open its top page in Notion and select **•••**, then **Export**. Use the same options, and turn on **Include subpages**.

Import the ZIP as Notion made it. If it contains more ZIP files, unzip only the outer one and import each inner ZIP.

### HTML or Markdown & CSV

Choose **HTML**. Both formats import, and links and images work in both. HTML keeps more of the page:

| Notion content                      | HTML                          | Markdown & CSV                  |
| ----------------------------------- | ----------------------------- | ------------------------------- |
| Text, headings, lists and links     | Kept                          | Kept                            |
| Page icon, cover and colours        | Kept                          | Removed                         |
| Toggles, callouts and columns       | Kept                          | Become plain text in one column |
| Tables with several lines in a cell | Kept                          | The table breaks                |
| Bookmarks                           | Kept, with the site icon      | Become plain links              |
| To-do lists                         | Kept, as read-only checkboxes | Kept, as task lists             |

Choose Markdown & CSV when your agents will edit the pages as Markdown.

## 2. Import the ZIP

1. In [Display](https://app.display.dev), open the Space or folder for the workspace.
2. Select **Create → Import ZIP**.
3. Choose the ZIP or drop it on the dialog. Display reads the ZIP in your browser and lists its files. Select a file to preview it.
4. Select **Continue**. Check the destination, the name of the new folder and who can open it.
5. Select **Import**.

Keep the dialog open until the import is complete. A large workspace takes some time: about 400 pages take 20 minutes. If you close the dialog or leave the page, the import stops. Files that Display already created stay in the new folder.

If the dialog shows a wait, Display has paused for a request limit. Select **Retry same request** to continue.

When the import is complete, select **Open folder**.

## What you get

- **One new folder.** An import never adds to or replaces an existing folder. To import again, choose a new destination or delete the first import.
- **The same tree.** Pages, subfolders, images, PDFs and other attachments keep their names and their place. Names keep the Notion ID at the end, for example `Roadmap 52eb42205ca44413a461f8ecf4a0bca3.html`. You can rename files after the import. Links still work.
- **Working links.** Links between imported pages and images open the imported file in Display.
- **Your access, not Notion's.** The new folder gets the access you choose in step 4. Every file in it uses that folder's access. Notion permissions do not come across. Change access later with **Share**.
- **Comments as text.** Notion comments and mentions in an HTML export stay in the page as text. They do not become Display comment threads.

## Databases

Notion exports a database as one CSV file and one page for each row. Display imports them as they are: the CSV file, plus a document for each row with its properties. The page that contained the database links to the CSV file. Display does not show the database as a table.

## Limits

- One ZIP up to 128 MB, with up to 10,000 files and folders, and up to 128 folder levels.
- Each file follows the ordinary upload limits for your plan. See [Plans and limits](/docs/limits).
- Notion API sync is not available. To bring later changes across, export and import again.

## After the import

Open any page and select **Edit** to change it, or ask your agent to update it. Share the folder with your team, or move it into another Space. See [Spaces and files](/docs/spaces).
