Import from Notion

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

How to Start the Import

1. Open Craft

   Open Craft (native app or web).

2. 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.

Set Up Your Notion Integration

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

1. Open your Notion Integrations

   Go to Notion Integrations to manage your integrations.

2. Create a new Integration

   Give it any name, choose your workspace, and hit Save.

   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.

3. Go to the Access tab

   Choose what documents you want to import. Only pages you grant access to will be included in the import.

4. Copy your Integration Key

   Go back to the Configuration tab and copy the Integration Key.

Import Your Documents

1. Paste your Integration Key

   Paste your Integration Key into the field on the import page.

2. 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.

3. Configure options

   Optionally toggle Include comments to import Notion comments alongside your pages (requires the Read comments capability — see above).

4. 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.

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

Invalid Notion integration token

Double-check that you copied the full Integration Key from the Configuration tab in your Notion integration settings.

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.

Import failed

Try restarting the import. If the issue persists, contact support.