Organize your library with tags and collections

Use tags and collections to keep your library organized. Tags are flexible labels you can reuse across any item. Collections are named groups for projects, reading lists, or topics.

Tags

Tags are best for themes that show up across lots of saved links.

  1. Open any item.
  2. Add tags from the item details.
  3. Type a tag name and press Enter or , to add it.
  4. Keep suggests matching existing tags as you type.

Each item can have up to 12 tags, and each tag can be up to 40 characters.

Edit a tag

You can rename a tag or add more detail from the sidebar.

  1. Find the tag in the left sidebar.
  2. Right-click the tag.
  3. Choose Rename or Edit details.

Use Edit details when you want to add a description for the tag.

Tag descriptions for AI auto-tagging

Tag descriptions help Keep choose the right existing tags when AI auto-tagging runs.

Describe what kinds of links belong in the tag, not just a shorter version of the tag name.

Good examples:

  • ai: Links about language models, AI products, agent tooling, and practical AI workflows.
  • design: Product design, UI patterns, visual systems, and interaction design references.
  • founder-mode: Writing about startups, company building, hiring, and operating teams.

Weak descriptions:

  • ai stuff
  • design links
  • things I like

To add or change a description:

  1. Right-click any tag in the sidebar.
  2. Choose Edit details.
  3. Add a description explaining when that tag should be used.
  4. Save.

Auto-tagging with AI

Keep supports two ways to use AI tagging:

  1. Turn on Tag new items automatically in Preferences to auto-tag links as you save them.
  2. Use Auto-tag with AI on an item when you want suggestions for that one item.

Keep looks at the item's title, URL, notes, content, your existing tags, and tag descriptions. It tries to reuse your current tags when they fit.

Source default tags and smart tag rules

Subscriptions can add tags before AI auto-tagging runs. This is useful when the source itself tells you something important about the item.

Default tags are added to every new item from a source. A Hacker News Show HN feed might use:

hacker-news, showhn-new

Every new item from that feed gets both tags. If you have another Show HN feed filtered by points or comments, you could use hacker-news, showhn-popular instead.

Smart tag rules add a tag only when the item matches a word, phrase, or URL pattern. Use one rule per line:

prompts: prompt, prompt engineering, system prompt
ai-tools: ai tool, copilot, agent
repos: url:github.com

The part before the colon is the tag Keep adds. The parts after the colon are the matches Keep looks for.

Normal matches check the item URL, title, notes, and saved content body. For RSS, articles, YouTube, X articles, and GitHub stars, Keep uses the extracted markdown body when it has one. For X bookmarks, it checks the captured post or article text. For email sources, it checks the resolved email body.

For example, this rule adds the prompts tag when any of those fields contains prompt, prompt engineering, or system prompt:

prompts: prompt, prompt engineering, system prompt

Use url: when a rule should only check the item URL:

repos: url:github.com

Keep also adds github-repo automatically for GitHub repository URLs and github-gist for GitHub gist URLs. A Show HN item that links to github.com/owner/project can end up with hacker-news, showhn-new, and github-repo.

Default tags and smart rule tags count as automated tags. They do not stop AI auto-tagging from adding more tags when Tag new items automatically is turned on.

Collections

Collections are best for grouping items into a specific bucket like a project, client, trip, or reading list.

  1. Open an item.
  2. Add a collection from the item details.
  3. Pick an existing collection or type a new name and press Enter.

An item can belong to multiple collections.

Filter by tag or collection

Click any tag or collection badge to filter your feed.

You can also type filters directly in search:

tag:design -- show items tagged design

in:reading-list -- show items in the reading-list collection

API and CLI

You can also manage tags and collections outside the app.

  • API: update an item's tags or collections with POST /api/items/:id
  • API: list tags with GET /api/tags
  • API: list collections with GET /api/collections
  • CLI: use keep tags and keep collections