Home/Docs/Tags & collections

Tags & collections

Use tags and collections to organize your saved content. Tags are freeform labels you can attach to any item. Collections are named groups for sorting items by topic or project.

Tags

Tags are short labels you attach to items. Each item can have up to 12 tags, and each tag can be up to 40 characters.

1. Open an item and click the tag icon or item details.

2. Type a tag name and press Enter or , to add it.

3. Keep suggests matching tags as you type from your existing tags.

4. Press Backspace on an empty input to remove the last tag.

You can also paste a comma-separated list of tags to add several at once.

Auto-tag with AI

If an item has fewer than 3 tags, you can click "Auto-tag with AI" in the item details. Keep uses AI to suggest tags based on the item's title, URL, notes, and content. You can remove any suggested tags you don't want.

Collections

Collections are named groups for organizing related items. An item can belong to multiple collections.

1. Open an item and click the folder icon or item details.

2. Type a collection name and select from the suggestions, or press Enter to create a new one.

3. Collections are created on the fly -- no need to set them up in advance.

Filtering by tag or collection

Click any tag or collection badge on an item to filter your feed. You can also type filters directly in the search bar:

tag:design -- show items tagged "design"

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

Tag and collection names autocomplete as you type.

Managing via API

Tags and collections are available through the API. Update an item's tags or collections with a POST to /api/items/:id. List all tags with GET /api/tags and all collections with GET /api/collections.

Managing via CLI

The CLI includes keep tags and keep collections commands for listing and managing tags and collections from the terminal.