> ## Documentation Index
> Fetch the complete documentation index at: https://vibekanban.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Creating Task Tags

> Create reusable text snippets that can be quickly inserted into task descriptions using @mentions. Task tags are available globally across all projects.

## What are task tags?

Task tags are reusable text snippets that you can quickly insert into task descriptions by typing `@` followed by the tag name. When you select a tag, its content is automatically inserted at your cursor position.

<Tip>
  Task tags use snake\_case naming (no spaces allowed). For example: `bug_report`, `feature_request`, or `code_review_checklist`.
</Tip>

## Managing task tags

Access task tags from **Settings → General → Task Tags**. Tags are available globally across all projects in your workspace.

<Frame>
  <img src="https://mintcdn.com/vibekanban/KZlPot0lA_mFkGT_/images/screenshot-task-tags-manager.png?fit=max&auto=format&n=KZlPot0lA_mFkGT_&q=85&s=ab02ae2b6b2a8476cfaa2367e79ae981" alt="Task tags management interface showing the tag list with names and content" width="3456" height="2160" data-path="images/screenshot-task-tags-manager.png" />
</Frame>

<Steps>
  <Step title="Create a new tag">
    Click **Add Tag** to create a new task tag.

    <Frame>
      <img src="https://mintcdn.com/vibekanban/KZlPot0lA_mFkGT_/images/screenshot-create-task-tag.png?fit=max&auto=format&n=KZlPot0lA_mFkGT_&q=85&s=e1c7a6dfa5ace6b76f06de2e3a736e50" alt="Create task tag dialogue showing tag name and content fields" width="2359" height="1235" data-path="images/screenshot-create-task-tag.png" />
    </Frame>

    * **Tag name**: Use snake\_case without spaces (e.g., `acceptance_criteria`)
    * **Content**: The text that will be inserted when the tag is used
  </Step>

  <Step title="Edit existing tags">
    Click the edit icon (✏️) next to any tag to modify its name or content.
  </Step>

  <Step title="Remove unwanted tags">
    Click the delete icon (🗑️) to remove tags you no longer need.

    <Warning>
      Deleting a tag does not affect existing tasks that already have the tag's content inserted.
    </Warning>
  </Step>
</Steps>

## Using task tags

Insert task tags into task descriptions and follow-up messages using @mention autocomplete.

<Steps>
  <Step title="Trigger autocomplete">
    When creating or editing a task description, type `@` to trigger the autocomplete dropdown.

    <Frame>
      <img src="https://mintcdn.com/vibekanban/KZlPot0lA_mFkGT_/images/screenshot-task-tag-autocomplete.png?fit=max&auto=format&n=KZlPot0lA_mFkGT_&q=85&s=9d4154b0d0b831d45aa345c0fe7dd65c" alt="Autocomplete dropdown showing available tags after typing @ symbol" width="1671" height="1292" data-path="images/screenshot-task-tag-autocomplete.png" />
    </Frame>
  </Step>

  <Step title="Search and select">
    Continue typing to filter tags by name, then:

    * Click on a tag to select it
    * Use arrow keys to navigate and press Enter to select
    * Press Escape to close the dropdown

    <Check>
      The tag's content is automatically inserted at your cursor position, replacing the @query.
    </Check>
  </Step>
</Steps>

## Common use cases

<AccordionGroup>
  <Accordion title="Bug report templates">
    Create a `bug_report` tag with standardised bug reporting fields:

    ```
    **Description:**

    **Steps to reproduce:**
    1. 
    2. 
    3. 

    **Expected behaviour:**

    **Actual behaviour:**

    **Environment:**
    ```
  </Accordion>

  <Accordion title="Acceptance criteria checklists">
    Create an `acceptance_criteria` tag for feature requirements:

    ```
    **Acceptance criteria:**
    - [ ] Functionality works as specified
    - [ ] Unit tests added
    - [ ] Documentation updated
    - [ ] Accessibility requirements met
    - [ ] Performance benchmarks passed
    ```
  </Accordion>

  <Accordion title="Code review guidelines">
    Create a `code_review` tag with review checklist items:

    ```
    **Code review checklist:**
    - [ ] Code follows project conventions
    - [ ] Tests cover edge cases
    - [ ] No security vulnerabilities introduced
    - [ ] Performance impact assessed
    - [ ] Documentation is clear
    ```
  </Accordion>
</AccordionGroup>

<Tip>
  Task tags work in all text fields that support the @mention feature, including task descriptions and follow-up messages, making it easy to maintain consistency across your tasks.
</Tip>
