Import bookmarks from other apps

Bring your existing bookmarks into Keep from another browser or service. Start from your import settings.

Bookmark imports are available on every plan. Upload exports from Pocket, Instapaper, Omnivore, Raindrop.io, Pinboard, Wallabag, Safari, or the Keep extension. You can also import a plain CSV or TSV file.

Document uploads are separate and require a paid plan.

Upload documents

Requires a paid plan.

Upload supported files and Keep converts them to markdown before saving them to your feed.

  1. Open settings -> import and click Upload document.
  2. Select one or more supported files.
  3. Keep converts them to markdown and saves them as items.

Supported formats depend on Cloudflare's markdown conversion support. Common examples include PDFs, office docs, spreadsheets, images, HTML, and XML.

Import X bookmarks

Import your X bookmarks from a JSON file exported by the Keep extension.

  1. Open settings -> import and click Import X bookmarks.
  2. Export your bookmarks JSON from the Keep extension.
  3. Select the file and click Import.

If the export already includes bookmark text and metadata, Keep preserves it. On paid plans, linked X articles can also keep their full content during import when it is available.

Import from file

Import bookmark exports from another read-later app, or import links from a plain CSV or TSV file.

  1. Open settings -> import and click Import from file.
  2. Select your export file.
  3. Preview the results and click Import.

Keep auto-detects these files:

Pocket -- ZIP, CSV, or HTML export.

Instapaper -- CSV export.

Omnivore -- JSON export or export ZIP.

Raindrop.io -- CSV or HTML export.

Pinboard -- JSON or XML export.

Wallabag -- JSON export.

Keep preserves URLs, titles, tags, saved dates, notes, archive state, starred state, collections, and highlights when those fields are present in the export.

For plain CSV or TSV files, Keep asks you to map the columns before importing.

Import Kindle highlights

Import your Kindle highlights, notes, and bookmarks from the My Clippings.txt file on your Kindle. One Keep item is created per book. See the Kindle docs for the full setup and what gets imported.

File format

The file must have a header row. Keep auto-detects whether the file is comma-separated or tab-separated.

One column is required:

URL -- the link to save. Keep recognises columns named url, link, href, source_url, or article_url.

Optional columns:

Title -- title or name.

Tags -- tags, labels, folders, or topics. Multiple tags can be separated by commas, pipes, or semicolons.

Saved date -- saved_at, created_at, date_added, or time_added. Accepts ISO dates or Unix timestamps.

If a column name does not match, you can map it manually in the preview step.

Exporting from other services

Most bookmark managers can export to CSV. Here are a few common ones:

Chrome -- open chrome://bookmarks, click the three-dot menu, and choose Export bookmarks. Save as HTML, then convert to CSV with any online converter, or paste the URLs into a spreadsheet and export as CSV.

Pocket -- upload the export ZIP from your download email, or an extracted Pocket CSV file.

Instapaper -- Settings on the desktop site -> Export -> CSV.

Raindrop.io -- Settings -> Export -> CSV.

Omnivore -- export your library as JSON or ZIP.

Pinboard -- export JSON or XML from Pinboard's backup/export tools.

Wallabag -- export JSON from Wallabag.

Import from Safari

Import your Safari Reading List directly from the macOS bookmarks file.

  1. Open settings -> import and click Import from Safari.
  2. Click Select file.
  3. In the file picker, press Shift + Command + G and paste the path: ~/Library/Safari/Bookmarks.plist
  4. Preview the results and click Import.

Both binary and XML plist formats are supported.

What gets imported

Each imported link is saved as a Keep item with an imported tag so you can filter them later. Platform imports also get a service tag like pocket, instapaper, omnivore, raindrop, pinboard, or wallabag. Safari imports also get safari and reading-list tags. Kindle imports get a kindle tag and land in a Kindle collection.

Uploaded documents are saved with an uploaded tag.

Imported items start as stashed. Free accounts keep the link, title, tags, dates, and other metadata from the import. Paid plans also fetch and keep full page content in the background when it is available. You can close the page after importing.

Uploaded documents skip that extra fetch step because the markdown is created during upload.

Limits

Each import is capped at 1,000 items. If you have more, split your file into batches and import each one separately. On paid plans, each imported item with kept full content counts toward your billing-cycle usage. Duplicates are skipped automatically at no cost.