Skip to main content
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:
  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. Voice tags
  3. Upload or record your audio sample and complete the cloning flow. See Voice Cloning for the full walkthrough.
  4. Your new voice will appear in your voice list with the assigned tags. Saved voice tags

​
Using voice tags

Voice tags are returned in the List voices in a workspace endpoint response, so you can filter and select voices programmatically: 
{
  "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": ""
}