# Tag

A variety of extra information about a metadata item is included as tags. These tags use their own element names such as `Genre`, `Writer`, `Directory`, and `Role`. Individual tag types may introduce their own extra attributes.



## Fields

| Field                                                                                       | Type                                                                                        | Required                                                                                    | Description                                                                                 | Example                                                                                     |
| ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| `confidence`                                                                                | *Optional\<Double>*                                                                         | :heavy_minus_sign:                                                                          | Measure of the confidence of an automatic tag                                               |                                                                                             |
| `context`                                                                                   | *Optional\<String>*                                                                         | :heavy_minus_sign:                                                                          | N/A                                                                                         |                                                                                             |
| `filter`                                                                                    | *Optional\<Object>*                                                                         | :heavy_minus_sign:                                                                          | A filter parameter that can be used to query for more content that matches this tag value.  | actor=49                                                                                    |
| `id`                                                                                        | *Optional\<Long>*                                                                           | :heavy_minus_sign:                                                                          | N/A                                                                                         |                                                                                             |
| `ratingKey`                                                                                 | *Optional\<String>*                                                                         | :heavy_minus_sign:                                                                          | N/A                                                                                         |                                                                                             |
| `role`                                                                                      | *Optional\<Object>*                                                                         | :heavy_minus_sign:                                                                          | The role this actor played                                                                  | Secretary                                                                                   |
| `tag`                                                                                       | *Optional\<Object>*                                                                         | :heavy_minus_sign:                                                                          | The value of the tag (the name)                                                             | Shaun Lawton                                                                                |
| `tagKey`                                                                                    | *Optional\<Object>*                                                                         | :heavy_minus_sign:                                                                          | Plex identifier for this tag which can be used to fetch additional information from plex.tv | 5d3ee12c4cde6a001c3e0b27                                                                    |
| `tagType`                                                                                   | *Optional\<Long>*                                                                           | :heavy_minus_sign:                                                                          | N/A                                                                                         |                                                                                             |
| `thumb`                                                                                     | *Optional\<Object>*                                                                         | :heavy_minus_sign:                                                                          | N/A                                                                                         | http://image.tmdb.org/t/p/original/lcJ8qM51ClAR2UzXU1mkZGfnn3o.jpg                          |