Skip to main content

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).

ConceptExample
Vocabulary"Project status", "Priority", "Department"
Tag"In progress", "Critical", "Engineering"
AssignmentA 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.