> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://poly-ai.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://poly-ai.ferndocs.com/_mcp/server.

# Voice library

> Browse, preview, and select voices for your agent.

The **Voice library** lets you explore, preview, and select voices for your agent. Access it from **Voice > Settings**.

![Voice library with the Test voice preview field, language, region, and gender filters, and a voice card showing Tara (English IE, Female) tagged Emotive and Friendly](/_fern-files/_img/6e04af1b79c15628ed013432058793449138d66ab40c82759aaa1e64ecb98fae.webp)

> **Note**
>
> The Voice library includes filters, favorites, and custom text preview.

## Accessing the Voice library

1. Go to **Voice > Settings** in the sidebar.
2. Click **Change** next to either the **Agent** or **Disclaimer** voice section.
3. The Voice library opens with two tabs: **Explore** and **Favorites**.

## Explore tab

Browse all available voices with filtering options:

| Filter       | Description                                                     |
| ------------ | --------------------------------------------------------------- |
| **Language** | Filter by supported language (e.g., English, Spanish, French)   |
| **Region**   | Filter by accent or regional variant (e.g., US, UK, Australian) |
| **Gender**   | Filter by voice gender                                          |

### Voice cards

Each voice displays:

* **Voice name** and provider
* **Language** and region flags
* **Style tags** describing the voice characteristics
* **Play button** to preview the voice

### Previewing voices

1. Click the **play button** on any voice card to hear a sample
2. Enter **custom text** in the preview field to hear your own content
3. Compare multiple voices before selecting

> **Tip**
>
> Preview voices with text that matches your agent's typical responses.

## Favorites tab

Save voices you frequently use or want to evaluate later.

* Click the **heart icon** on any voice card to add it to Favorites.
* Access your saved voices quickly from the **Favorites** tab.
* Remove voices from Favorites by clicking the heart icon again.

## Selecting a voice

1. Find a voice using **Explore** or **Favorites**.
2. Click the voice card to select it.
3. Click **Select** to apply the voice to your agent.

The selected voice is applied to either the **Agent** or **Disclaimer** section depending on which **Change** button you originally clicked.

## Voice settings

After selecting a voice, fine-tune its Stability, Clarity, and Style parameters. See [Agent Voice – voice settings](/agent-studio/voice/settings#voice-settings) for full details on each slider.

## Separate voice management

The Voice library supports separate voice selection for **Agent** (main voice) and **Disclaimer** (legal/informational). See [Agent Voice](/agent-studio/voice/settings) for details on each section.

## Publishing changes

After selecting and configuring voices, click **Publish** in the top right corner to apply changes. See [Agent Voice – publishing](/agent-studio/voice/settings#publishing-changes) for details.

## Related pages

#### [Agent Voice](/agent-studio/voice/settings)

Configure voice settings and fine-tuning

#### [Choosing a good voice](/agent-studio/voice/voice-design/choosing-a-good-voice)

Guidelines for voice selection and matching

#### [Voice configuration](/agent-studio/voice/advanced-settings)

Channel-specific voice and call handling settings

#### [Multi-voice](/agent-studio/voice/voice-design/multi-voice)

Use multiple voices in a single agent