# Runbook: move Notion pages and databases to Bundle

> For AI agents acting for a Bundle owner or admin. Human version: https://bundle.direct/blog/migrate-from-notion
> Last checked against Bundle on 2026-10-25.

## Goal

Copy Notion pages, nested pages and databases (inline ones included) into Bundle's Pages, organized into sections. Notion is only read.

## How you act

- Run the import in the Bundle web app (https://app.bundle.direct), signed in as an **owner or admin**: Settings → Import → Notion. Bot tokens can't run imports.
- Drive the user's signed-in browser session; don't create accounts.
- **Never ask for the Notion secret in chat.** The human pastes it into Bundle's field, or a password-manager/secret-handoff tool fills it without showing you the value.

## Prerequisites

- [ ] Bundle workspace; user is owner or admin.
- [ ] Notion: the user can create integrations in the Notion workspace (workspace owner) or can export the workspace.
- [ ] No other workspace import running (one at a time).
- [ ] Ask the user which top-level pages to bring, and whether any section should be private.

## Steps

### A. Integration token (recommended: keeps property types)

1. Bundle: `https://app.bundle.direct/<workspace>/settings/import` → **Notion** → **Connect with a token**. **Open Notion integrations** goes to https://www.notion.so/profile/integrations.
2. **Human step:** create an **internal integration** with the **Read content** capability only.
3. **Human step:** share each top-level page with it in Notion: **••• → Connections → (the integration)**. Subpages and databases inside come along. If Bundle later says "The integration can't see any page", this step was missed.
4. **Human step (secret):** put the integration secret (`ntn_…` or older `secret_…`) into **Notion integration secret**, then click **Connect**. It's kept only while the import runs.

### B. Export zip

1. **Human step:** Notion **Settings → General → Export all workspace content**, format **Markdown & CSV**, include subpages and files.
2. Upload the download in **Settings → Import → Notion → Export file** (≤ 1 GB; a download containing `Part-N.zip` files works as is). HTML exports are rejected ("no pages (.md) or databases (.csv) inside").

### C. Review

1. Banner **Sorted with AI** means AI proposed 2–8 sections (each becomes a top-level page), suggested first views for databases (board, calendar, list or table; an "All" table is always added) and titles for untitled pages. It read only titles, paths, column names and ≤ 200-character snippets. Without AI the timeline says "Kept the source's own layout (no AI sorting)".
2. With the user: rename/remove sections, **Add section**, move pages, set each section **Shared** or **Private**, untick what shouldn't come.
3. Click **Import**.

## What converts

- Pages and nested pages (emoji icons), databases incl. inline, rows with their page bodies.
- Properties (integration): title, text, phone, number/percent/currency, select, multi-select, status (options and colors), date, checkbox, URL, email; relations when the target database is imported; created/edited time and by become automatic fields (show Bundle's values).
- Properties (export): types guessed from CSV values; created/edited columns skipped.
- Blocks: toggles, callouts (emoji), code (language), quotes, lists, to-dos, dividers, images/files (≤ 1 GB, copied), embeds/bookmarks/link previews (embed blocks), synced blocks/columns/tabs (inlined), simple tables (plain-text cells), page/database mentions, equations (LaTeX code block with the integration; text with an export).

## What doesn't

- Formulas and rollups: dropped (integration); exported values become static columns (export).
- Unique ID, button, verification, place properties: dropped.
- People and file property values: empty with the integration; person mentions become plain `@Name`.
- Comments; table of contents, breadcrumb, template, meeting-notes blocks; subpages inside database rows (export).
- Pages over 5,000 blocks are cut; text cells capped at 10,000 characters.

## Under the hood (signed-in session only)

`POST /v1/w/:ws/imports` (create), `GET /v1/w/:ws/imports/:id` (status + preview), `POST /v1/w/:ws/imports/:id/start`, `POST …/cancel`, `POST …/rescan`. Prefer the UI.

## Verify

1. Settings → Import: status **Imported**; read the timeline.
2. In Pages, each section exists with the right sharing; open two databases, switch views, check column types and relations.
3. Spot-check a long page and an image-heavy page.
4. List formulas/rollups the user relies on and tell them which need rebuilding.

## Rollback

- Notion is unchanged. **Stop import** halts a running job (already imported pages stay).
- Delete unwanted sections/pages in Bundle.
- **Human step:** remove the integration's connections or delete the integration in Notion.
