Bring your Pocket archive in.

Pocket shut down in July 2025. If you exported your archive before the door closed — or you’re working from the zipped CSV email Pocket sent out — Shelf reads both formats and folds them into your library. No server in the middle. The file never leaves your browser.

Get your Pocket export

If you still have a logged-in Pocket window or a copy of the legacy export tool, you have one of two files:

• ril_export.html — the classic Pocket HTML export. Two sections: Unread and Read Archive. Each item is an <a> with time_added and tags attributes.
• pocket.csv — the recent zipped-email export. Columns: title, url, time_added, tags, status (where status is archive for archived items).

Either file works.

Where to upload it

Open Shelf’s Options page. The Import from Pocket section sits near the top, before Destinations. Drag your .html or .csv file onto the drop zone, or click Choose file and pick it from your file system. Shelf parses the file in your browser, deduplicates against URLs already in your library, and stores the new items in chrome.storage.local. No upload, no network call.

What gets imported

For each Pocket item Shelf brings in:

• URL — the original link. Required; rows with invalid URLs are skipped and counted as invalid links in the summary.
• Title — the title Pocket stored. Falls back to the URL when Pocket didn’t have one.
• Saved at — Pocket’s time_added (UNIX seconds, multiplied to milliseconds). Falls back to “now” when missing or malformed.
• Tags — Pocket’s comma-separated (HTML) or pipe-separated (CSV) tag list, trimmed.
• Kind — inferred from the URL hostname: video for YouTube/Vimeo, podcast for Spotify/Apple Podcasts/Google Podcasts, otherwise article.

What Shelf does not bring in: excerpts, thumbnails, reading time, and highlights — Pocket’s export doesn’t include those reliably. Your imported items live alongside your own saves; re-save any of them by visiting the URL and pressing Alt + S if you want the full metadata.

Deduplication

Imports are deduplicated against existing items by URL. If you import the same export twice, the second pass is a no-op for already-present URLs. The summary at the end shows three numbers: items found, items added, items skipped as duplicates.

That’s it. Move on to collections and destinations once your library is back.