A migration guide

Pocket to Notion,
in 2026.

Pocket's export gives you an HTML or CSV. This page walks through getting your archive into a Notion database two ways: automated (3 minutes with Shelf) or manual (30 minutes, no extension required).

Step 1 — Export your Pocket archive

  1. Open getpocket.com/export (this URL still works as of late 2025 — Mozilla left the export tool live for migration).
  2. Sign in with the Firefox account you used for Pocket.
  3. Pick HTML — it's more complete than CSV, includes tags, time_added, and read/unread state.
  4. Download the .html file. Save it somewhere safe; your library is in there.

The HTML is a single file, one big nested list. Each item has the URL, title, time_added (unix timestamp), and a `tags` attribute. That's the raw material for your migration.

Step 2 — Set up a Notion database

Open Notion. Create a new full-page database (Table view). Suggested schema:

  • Title — title property (default)
  • URL — URL property
  • Source — rich text (e.g., "theatlantic.com")
  • Kind — select (article / video / podcast / page)
  • Saved at — date property
  • Tags — multi-select
  • Excerpt — rich text (optional)
  • Read — checkbox (optional)

Tip: name the database something like "Library" so it's clearly the source-of-truth, not just "Pocket import". Future you will appreciate the naming when this database holds 5,000+ items.

Step 3 — Path A: Automated import via Shelf (3 minutes)

The fastest path. Requires installing Shelf (free Chrome extension).

  1. Install Shelf from the Chrome Web Store. (Coming soon — join the waitlist.)
  2. Open Shelf's Options page.
  3. Go to Integrations → Notion → "Connect".
  4. In Notion, create an internal integration at notion.so/profile/integrations. Copy the integration token (starts with secret_ or ntn_).
  5. Paste the token into Shelf. Share your Library database with the integration (in Notion: open database → "..." menu → Connections → add the integration).
  6. Pick the Library database as the destination.
  7. Go to Library Tools → Import from Pocket → drag and drop the .html file. About 1,200 items per minute on a basic laptop.

What gets migrated: URL, title, tags, time_added (→ Saved at). The kind ("article/video/podcast") is detected by URL pattern on the way in — YouTube becomes video, Spotify becomes podcast, anything matching common article hosts becomes article.

Step 3 — Path B: Manual CSV import (30+ minutes)

If you don't want to install Shelf or another extension:

  1. Convert the Pocket HTML to CSV. The HTML structure is <a href="URL" time_added="..." tags="tag1,tag2">Title</a> wrapped in lists. A small script (Python BeautifulSoup, or a one-liner with pup + jq) converts each link to a CSV row.
  2. In Notion's Library database, click the "..." menu → Merge with CSV.
  3. Map columns: Pocket's URL → Notion URL, Pocket's title → Notion Title, Pocket's tags → Notion Tags (you may need to split the comma-separated string).
  4. Confirm the import. Notion will create one row per Pocket link.

The downside of the manual route: Notion's CSV import doesn't split multi-select fields automatically. Your tags arrive as a single string ("essay, philosophy, climate") that you'll re-split later in batches.

What does not migrate (be honest with yourself)

Pocket's HTML export doesn't include:

  • Annotations / highlights. Pocket lost these in the export tool's first release; later they were restored but truncated. Most users I've talked to recovered only ~30%.
  • The article HTML. You get the URL, not the saved text. If the source page goes 404 in five years, the article is gone.
  • The AI-generated tags. Pocket's Premium AI-tag feature was server-side. Those tags are not in the export.
  • The "Top Articles" personalised feed history. Lost.

What you preserve: URL, title, manual tags, time_added, read state. That's enough to rebuild the library structure. The reading itself, alas, has to be re-done — or accepted as a chapter that's already happened.

After migration: ongoing saves

One-shot migration is the easy part. The harder question is where your next 2,400 saves should go. Three options:

  • Use Notion's official Web Clipper. Free, built-in. Works fine for Notion-natives but no AI tagging, no YouTube transcripts, no Markdown backup.
  • Use Shelf. Press Alt+S on any article → it lands in your Notion database in ~2 seconds. AI auto-tag (Pro feature), YouTube transcript with clickable timestamps, optional Markdown file backup of every save.
  • Switch to a different read-later entirely. See the Pocket alternatives comparison.

Schema gotchas

If you're a heavy Notion user, three small details will save you future pain:

  • Use URL property type for the URL, not rich text. Notion treats URLs differently (clickable, indexed by search) when they're stored as URL property.
  • Use Saved at as date (not last edited time). You want to query "what did I save in March 2024" later, and Notion's date filters are powerful only on real date properties.
  • Don't use Title for the URL. Some migration guides do that to make the link clickable; it's a hack. Keep Title for the article's title — clickability comes from the URL property automatically.

Related

Try the migration tool

Shelf imports Pocket archives in ~1,200 items per minute and routes them to your Notion database. Launches on the Chrome Web Store soon — leave your email and I'll write once when it's live.

One email · No marketing · Unsubscribe in any client