# How can I add tags to cases?

## Setup

To use case tags, you must first create some within your organization's settings area. To do this, follow the instructions [here.](https://help.hummingbird.co/features/tag-management)

## Usage

### On the Canvas

Tags can be added to cases by clicking the button within the case header. The tags defined within the organization's settings are available for selection or deselection.

<figure><img src="https://1147732760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmzoYz7iOm57ON4l86wx0%2Fuploads%2FBBl1Mq5oeWatpC9FQW2y%2FCleanShot%202024-10-16%20at%2007.59.26.png?alt=media&#x26;token=a034b135-9c62-40aa-8ac6-a0970c2910a3" alt=""><figcaption></figcaption></figure>

### On the Dashboard

* Enable the Case Tags column to view tags\
  ![](https://1147732760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmzoYz7iOm57ON4l86wx0%2Fuploads%2Fj4fxA6J5SlhOERF4POgs%2FCleanShot%202024-10-16%20at%2008.07.46.png?alt=media\&token=6be487e4-7c05-4f9a-8362-1b9058c63202)
* Type a tag name in the search bar to see all reviews in cases carrying that tag<br>

  <figure><img src="https://1147732760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmzoYz7iOm57ON4l86wx0%2Fuploads%2FNyWpCiQTHahKs6B4GRll%2FCleanShot%202024-10-16%20at%2008.09.08.png?alt=media&#x26;token=d8f8032a-98b4-4847-8bb2-524599dad768" alt=""><figcaption></figcaption></figure>
* Use in filters to return reviews in cases carrying that tag<br>

  <figure><img src="https://1147732760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmzoYz7iOm57ON4l86wx0%2Fuploads%2FQIhOVSWOLLfS47TVqj2Z%2FCleanShot%202024-10-16%20at%2008.10.35.png?alt=media&#x26;token=978a6057-08ac-4f18-b721-add02f6fafee" alt=""><figcaption></figcaption></figure>

### Using the API

Case tags can be added, removed, and retrieved beginning with the `v2024-09-04` version of the API. Usage documentation is [here.](https://docs.hummingbird.co/reference/cases_tag_get)&#x20;