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

# Voice Tags

Voice tags are descriptive metadata labels attached to each voice, helping you categorize and filter voices based on their characteristics. Tags describe properties like gender, age group, tone, and style, making it easier to find the right voice for your use case.

## Understanding voice tags

Each voice includes a `tags` array with descriptive labels such as:

* **Gender**: `male`, `female`, `non-binary`
* **Age group**: `young_adult`, `adult`, `middle-aged`, `elderly`
* **Vocal style**: `energetic`, `calm`, `professional`, `friendly`, `warm`
* **Voice quality**: `smooth`, `clear`, `expressive`, `conversational`

## Adding voice tags

You can add custom tags to a voice when cloning it in the [TTS Playground](https://platform.inworld.ai/tts-playground):

1. In the TTS Playground, click **Create a Voice** and select **Clone**.
2. Enter a name for your voice, then add tags — press Enter after each tag to add it to the list.
   <img src="https://mintcdn.com/inworldai/CMlU9hQvIvEdFmh4/img/tts/voice_tags.png?fit=max&auto=format&n=CMlU9hQvIvEdFmh4&q=85&s=779e0f99a0d3002ce683d64ef533d055" alt="Voice tags" width="1794" height="1524" data-path="img/tts/voice_tags.png" />
3. Upload or record your audio sample and complete the cloning flow. See [Voice Cloning](/tts/voice-cloning) for the full walkthrough.
4. Your new voice will appear in your voice list with the assigned tags.
   <img src="https://mintcdn.com/inworldai/CMlU9hQvIvEdFmh4/img/tts/saved_voice_tags.png?fit=max&auto=format&n=CMlU9hQvIvEdFmh4&q=85&s=2b1fd4ca98183c0389d604ffca193e87" alt="Saved voice tags" width="760" height="694" data-path="img/tts/saved_voice_tags.png" />

## Using voice tags

Voice tags are returned in the [List voices in a workspace](/api-reference/voiceAPI/voiceservice/list-voices) endpoint response, so you can filter and select voices programmatically:

```json theme={"system"}
{
  "voices": [
    {
      "voiceId": "my_workspace__my_custom_voice",
      "displayName": "My Custom Voice",
      "description": "A warm narrator voice",
      "promptLanguages": ["en-US"],
      "tags": ["female", "adult", "warm", "expressive"],
      "source": "IVC"
    }
  ],
  "totalSize": 1,
  "nextPageToken": ""
}
```