> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Import from Notion

> Import your Notion workspace, pages, and databases directly into Craft — no file export needed.

## How to Start the Import

<Steps>
  <Step title="Open Craft">
    Open Craft (native app or web).
  </Step>

  <Step title="Start the import">
    Click the **Import** icon at the bottom of the left sidebar and select **Import from Notion**. This opens the import page at [docs.craft.do/import/notion](https://docs.craft.do/import/notion).
  </Step>
</Steps>

## Set Up Your Notion Connection

The import page will guide you through four steps to connect your Notion workspace:

<Steps>
  <Step title="Open Connections in the Notion developer portal">
    Go to [Notion Connections](https://www.notion.so/profile/integrations) to manage your connections.

    <Frame>
      <img src="https://mintcdn.com/craft-support/9KzkdoQZab9X8gR2/images/import-and-export/import/notion/en/content/notion-connections-page.png?fit=max&auto=format&n=9KzkdoQZab9X8gR2&q=85&s=4c3ec3ae73f37d247f669fc0a9f2abaa" alt="Notion Connections page with New connection button" width="1875" height="1153" data-path="images/import-and-export/import/notion/en/content/notion-connections-page.png" />
    </Frame>
  </Step>

  <Step title="Create a new Connection">
    Give it any name, select **Access token**, choose your workspace, and hit **Save**.

    <Frame>
      <img src="https://mintcdn.com/craft-support/9KzkdoQZab9X8gR2/images/import-and-export/import/notion/en/content/notion-new-connection-dialog.png?fit=max&auto=format&n=9KzkdoQZab9X8gR2&q=85&s=9cdd00d23182e9aa20a4b8cf5bb34928" alt="Notion New connection dialog with Access token selected" width="1827" height="1067" data-path="images/import-and-export/import/notion/en/content/notion-new-connection-dialog.png" />
    </Frame>

    <Warning title="Set the correct capabilities">
      When creating your connection, make sure to configure the following capabilities:

      * **Read content** — this is **required** for the import to work. Without it, Craft cannot access your Notion pages.
      * **Read comments** — enable this if you want to import comments from your Notion pages. This must be selected **before** starting the import.

      You can configure capabilities in the **Capabilities** section of your connection settings.
    </Warning>
  </Step>

  <Step title="Go to the Content access tab">
    Add the pages and databases you want to import. You have to add every page individually — you cannot select the entire workspace at once. Only pages you grant access to will be included in the import.

    <Frame>
      <img src="https://mintcdn.com/craft-support/9KzkdoQZab9X8gR2/images/import-and-export/import/notion/en/content/notion-content-access-tab.png?fit=max&auto=format&n=9KzkdoQZab9X8gR2&q=85&s=ddbdf359ede63c543106538bfbee4352" alt="Notion Content access tab with pages and databases selected" width="1827" height="1067" data-path="images/import-and-export/import/notion/en/content/notion-content-access-tab.png" />
    </Frame>
  </Step>

  <Step title="Copy your Access token">
    Go back to the **Configuration** tab and copy the **Access token**.
  </Step>
</Steps>

## Import Your Documents

<Steps>
  <Step title="Paste your Access token">
    Paste your Access token into the field on the import page.
  </Step>

  <Step title="Choose your destination">
    Select the **Craft Space** where you want your Notion documents to appear. Optionally select a **destination folder** to organize your imported documents.
  </Step>

  <Step title="Configure options">
    Optionally toggle **Include comments** to import Notion comments alongside your pages (requires the **Read comments** capability — see above).
  </Step>

  <Step title="Start the import">
    Click **Import**. You'll see a progress bar as your documents are imported. You can close the page at any time — the import will continue in the background.
  </Step>
</Steps>

## After the Import

Once complete, you'll see a confirmation with a button that takes you to Craft, where you'll find your imported documents.

## Limitations

* **Linked databases** are not imported. Only original databases and standalone pages are included. Linked (mirrored) database views will be skipped.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Invalid Notion access token">
    Double-check that you copied the full Access token from the **Configuration** tab in your Notion connection settings.
  </Accordion>

  <Accordion title="No pages or databases found">
    Make sure you selected the individual pages and databases you want to import in the **Content access** tab of your Notion connection settings. You have to select each page individually. Also verify that **Read content** is enabled under **Capabilities**.
  </Accordion>

  <Accordion title="Import failed">
    Try restarting the import. If the issue persists, contact support.
  </Accordion>
</AccordionGroup>