Getting Started with Tags
Tags are reusable labels you can attach to almost anything in your workspace — projects, files, tasks, calendar events, contacts. They make it easy to find related items, build saved filters, and keep large workspaces organised.
Where to find tags
Open the host app (for example, vibecontrols-app) and navigate to:
- /tags/ — the landing page. Shows recent tags, search, and quick links to list, analytics, and templates.
- /tags/list — the full list of tags in your workspace with search, filtering, and bulk selection.
You need to be signed in and have at least tag:read permission on the
workspace.
Tag basics
Every tag belongs to a vocabulary. A vocabulary is a namespace — it groups related tags and decides how they behave (single-select vs multi-select, required vs optional, custom values allowed or only predefined ones).
| Concept | Example |
|---|---|
| Vocabulary | "Project status", "Priority", "Department" |
| Tag | "In progress", "Critical", "Engineering" |
| Assignment | A specific tag attached to a specific entity |
You generally pick a vocabulary first, then a tag from it. For example: choose the Priority vocabulary, then attach the Critical tag to a task.
Quick actions
- Create a tag → /tags/new
- Browse and search → /tags/list
- Manage who can change a tag → /tags/permissions
- See how often a tag is used → /tags/analytics
What tags are not
- Tags are not comments or descriptions. Use the entity's notes/description for free-form text.
- Tags are not access controls. To restrict who can see an item, use the entity's permissions, not a tag.
- Tags are not secret-bearing fields. Don't put credentials, tokens, or PII into tag labels.