Tags

Tags offer a flexible, cross-cutting way to categorize your snippets. Unlike folders, which enforce a single hierarchy, a snippet can have any number of tags, letting you find it through multiple paths.

Creating Tags

From a Snippet

1. Select a snippet in the list.
2. In the snippet detail area, locate the Tags field.
3. Click the tags field and start typing a tag name.
4. If a matching tag exists, select it from the suggestions.
5. If no match is found, press Enter to create a new tag with that name.

From the Sidebar

1. In the sidebar, find the Tags section.
2. Right-click and select New Tag.
3. Enter the tag name and choose a color.

Custom Tag Colors

Each tag can have a custom color for easy visual identification:

1. Right-click a tag in the sidebar.
2. Select Edit Tag or Change Color.
3. Choose from the color palette.

Color-coded tags make it easy to scan the snippet list and quickly identify snippets by category. For example:

• Red -- Critical / Production
• Blue -- Backend
• Green -- Frontend
• Orange -- Work in Progress
• Purple -- Utilities

You can choose whatever color scheme works for your workflow.

Adding Tags to Snippets

From the Detail View

1. Select a snippet.
2. Click the Tags field in the detail area.
3. Type to search existing tags or create new ones.
4. Click a tag or press Enter to add it.

Multiple Tags

A snippet can have as many tags as you need. Common patterns include tagging by:

• Language -- python, javascript, sql
• Purpose -- utility, template, example, debug
• Project -- project-alpha, website, api-v2
• Status -- wip, reviewed, deprecated

Filtering by Tags

Sidebar Filter

Click a tag in the sidebar Tags section to filter the snippet list to only snippets with that tag. The active tag filter is highlighted in the sidebar.

Multiple Tag Filters

You can click multiple tags to filter by several tags at once. The snippet list shows snippets that match any of the selected tags (OR logic).

Combining with Folders

Tag filters work alongside folder selection. If you select a folder and a tag, the snippet list shows only snippets that are in that folder and have that tag.

Managing Tags

Renaming a Tag

1. Right-click the tag in the sidebar.
2. Select Rename.
3. Enter the new name and press Enter.

The rename applies to all snippets that use the tag.

Deleting a Tag

1. Right-click the tag in the sidebar.
2. Select Delete.
3. Confirm the deletion.

Deleting a tag removes it from all snippets. The snippets themselves are not deleted -- only the tag association is removed.

Removing a Tag from a Snippet

1. Select the snippet.
2. In the tags field, click the X button next to the tag you want to remove.

Tag Best Practices

• Be consistent -- Decide on a tagging convention and stick to it. Use lowercase, hyphenated names (e.g., error-handling) for consistency.
• Avoid redundancy -- If a folder already captures a category (e.g., "Python"), you may not need a python tag as well -- unless you want to find all Python snippets across folders.
• Review periodically -- Remove unused tags to keep the sidebar clean. If a tag has zero snippets, consider deleting it.
• Use tags for cross-cutting concerns -- Tags shine for concepts that span multiple folders, such as authentication, caching, or tested.

Related

• Folders -- Hierarchical organization for broad categories.
• Workspaces -- Tags are scoped to the active workspace.
• Favorites -- Another way to surface important snippets.