> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.app/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 Integration

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

<Steps>
  <Step title="Open your Notion Integrations">
    Go to [Notion Integrations](https://www.notion.so/profile/integrations) to manage your integrations.
  </Step>

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

    <Warning title="Set the correct capabilities">
      When creating your integration, 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 integration settings.
    </Warning>
  </Step>

  <Step title="Go to the Access tab">
    Choose what documents you want to import. Only pages you grant access to will be included in the import.
  </Step>

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

## Import Your Documents

<Steps>
  <Step title="Paste your Integration Key">
    Paste your Integration Key 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 integration token">
    Double-check that you copied the full Integration Key from the **Configuration** tab in your Notion integration settings.
  </Accordion>

  <Accordion title="No documents found">
    Make sure you gave access to all documents you want to import in the **Access** tab of your integration settings. 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>