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
- Open getpocket.com/export (this URL still works as of late 2025 — Mozilla left the export tool live for migration).
- Sign in with the Firefox account you used for Pocket.
- Pick HTML — it's more complete than CSV, includes tags, time_added, and read/unread state.
- 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 propertySource— rich text (e.g., "theatlantic.com")Kind— select (article / video / podcast / page)Saved at— date propertyTags— multi-selectExcerpt— 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).
- Install Shelf from the Chrome Web Store. (Coming soon — join the waitlist.)
- Open Shelf's Options page.
- Go to Integrations → Notion → "Connect".
- In Notion, create an internal integration at
notion.so/profile/integrations.
Copy the integration token (starts with
secret_orntn_). - Paste the token into Shelf. Share your Library database with the integration (in Notion: open database → "..." menu → Connections → add the integration).
- Pick the Library database as the destination.
- 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:
- 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 withpup+jq) converts each link to a CSV row. - In Notion's Library database, click the "..." menu → Merge with CSV.
- 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).
- 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