Organise your Keep library

Keep has three ways to organise context:

• Tags label Notes and Items by topic.
• Collections group saved Items.
• Projects group project Notes and repository context.

Add tags to an Item

1. Open an Item.
2. Open the Item actions.
3. Select Tags.
4. Select an existing tag or enter a new tag.

An Item can have up to 12 tags. Each tag can contain up to 40 characters.

You can also add tags while you save a link. Type in the Tags field and choose an existing tag or add a new one. The save screen shows your choices immediately and saves them in the background.

Add tags to a Note

1. Open a Note.
2. Open its properties.
3. Select an existing tag or enter a new tag.

The Tags page combines the Notes and Items for each tag.

Manage tags

Open Tags from the app navigation. You can search tags, create a tag, rename a tag, or add a description.

Open a tag to see its Notes and Items. The action menu beside the tag name lets you rename the tag, edit its description, or delete it.

A description tells people and agents what belongs in the tag. Write a direct rule.

Design systems, interface patterns, and interaction references.

Deleting a tag removes it from Notes and Items. It does not delete the Notes or Items.

Use automatic tags

Keep can suggest tags for one Item. Open the Item actions and select the automatic tag action.

Paid plans can also tag new Items during capture. Open Settings, then open General. Turn on automatic tags under Capture defaults.

Automatic tagging runs when Keep finishes capturing the available content. Tags you add yourself are merged with automatic tags and are not replaced. Automatic tags appear later on the Item, not while you are using the save screen.

Keep uses the Item title, URL, saved reason, content, existing tag names, and tag descriptions.

Set tags for a source

A source can add tags to every new Item that it saves.

Open Settings, then open Sources. Edit the source and add default tags.

You can also add smart tag rules. Use one rule per line:

prompts: prompt, prompt engineering, system prompt
repositories: url:github.com

The text before the colon is the tag. The values after the colon are matches. Use url: when a rule must check only the Item URL.

Source tags do not stop automatic tagging from adding other tags.

Use collections

Collections group Items for a specific purpose, such as a client, reading list, or research topic.

1. Open an Item or the link capture form.
2. Tap an existing collection or enter a new one.

An Item can belong to more than one collection. Collections do not contain Notes.

Filter your library

Select a tag from the Tags page to see its Notes and Items. Use the Feed search to filter Items by tag or collection.

tag:design
in:"Agent research"

Global search also supports project:, kind:, and state: for Notes. See Search for the full filter list.

Use the API and CLI

Use the API to list and update tags and collections. Use the CLI for common list and create operations.

keep tags list
keep collections list
keep collections add "Agent research"

See the API reference and CLI guide for details.