Home/Docs/Import

Import

Bring your existing bookmarks into Keep from another browser or service. Import is available from your settings.

Upload documents

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 from file

Import links from a CSV or TSV file.

1. Open settings → import and click Import from file.

2. Select a .csv or .tsv file.

3. Map the columns to Keep fields.

4. Preview the results and click Import.

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 — go to getpocket.com/export and download the HTML file, then convert to CSV.

Raindrop — Settings → Export → CSV.

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. Safari imports also get safari and reading-list tags.

Uploaded documents are saved with an uploaded tag.

Imported items start as stashed. After import, Keep fetches each page and extracts the full content as markdown in the background. This happens automatically — 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. Each imported link uses 1 credit. Duplicates are skipped automatically at no cost.