---
title: Tags
description: The Tags app adds a field type for building and selecting a list of string labels.
url: https://www.storyblok.com/docs/apps/tags
---

# Tags

The Tags app adds a field type for maintaining a list of labels, such as `electronics`, `clothing`, and `books` on a product. The field returns the selected values as JSON, together with the plugin metadata.

## Features

-   Build a list of strings in one field.
-   Select and display distinct labels.
-   Set a placeholder shown while the field is inactive.
-   Populate the field with an initial set of tags.

## Setup

In the **Block Library**, select the block you want to edit, add a field, set its field type to **Plugin**, and set the custom type to `storyblok-tags`.

The field takes the following options:

| Option | Description |
| --- | --- |
| `placeholder` | Text shown while the field is inactive. |
| `initialValue` | JSON-encoded array of strings shown when the field loads. Use `[]` for no tags. |

Example `initialValue`:

```json
["AUS", "BRA", "FRA", "SWE", "ITA"]
```

## Output

The field returns an object like the following:

```json
{
  "fieldname": {
    "value": ["AUS", "BRA", "FRA", "SWE", "ITA"],
    "plugin": "storyblok-tags"
  }
}
```

## Further resources

[Tags in the app directory](https://www.storyblok.com/apps/storyblok-gmbh@tags)

## Pagination

-   [Previous: Sylius](/docs/apps/sylius)
-   [Next: Task Manager](/docs/apps/task-manager)
