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

# Choose a voice for your agent

> Browse voices by dialect and gender, listen to them, keep favorites, and pick the voice your agent speaks with. The voice also sets the agent's language.

The voice is how your agent sounds on calls and chats. Browse and listen to voices on the **Voices** page, then pick one in the agent's voice settings. Picking a voice also sets the agent's language and dialect, so choose one that matches your callers.

## Browse voices

Open **Voices** in the sidebar. Use **Section** to switch between **Voices** and [**Dictionaries**](https://docs.tryhamsa.com/agents/voices/dictionaries.md).

![The Voices page with Show set to All, the dialect tiles Gulf Arabic, Levantine Arabic, Egyptian Arabic, Iraqi Arabic, Fusha (MSA) and English, and the voice list with Sounds and Good for columns](https://mintcdn.com/hamsa-452fa79a/7GY0-8K2sfzXu6G7/images/agents/voices/voices-page-light.webp?fit=max\&auto=format\&n=7GY0-8K2sfzXu6G7\&q=85\&s=af013d40e7fa983826f99de536b11fdc)

**Show** narrows the list:

| Option | What it shows |
| - | - |
| **All** | Every voice you can use |
| **Favorites** | Voices you starred. "Only you see your favorites." |
| **In your agents** | "Voices your agents speak with" |
| **Project voices** | Voices added to this project from cloning. "Everyone in this project can use it." |

To find a voice faster:

* **Search** by name, dialect or tone.
* Filter by **Dialect** (the caller's dialect) and **Gender**.
* Open a dialect collection from the row of tiles at the top: Gulf Arabic, Levantine Arabic, Egyptian Arabic, Iraqi Arabic, Fusha (MSA) and English.

The list shows each voice's name, how it **Sounds** and what it is **Good for**. Play a voice to hear its sample, or click **Play all** to listen through the list. The player has **Previous voice** and **Next voice**.

## Use a voice in an agent

**1. Open the agent's voice settings**

In a single prompt agent, open **Voice settings**. In a flow agent, open **Global settings**. See [Voice, language and dialect](https://docs.tryhamsa.com/agents/settings/voice-and-language.md).

**2. Open the voice picker**

Click the voice field (**Select voice**, or **Change** if a voice is set). **Select agent voice** opens in the Configuration panel, with the same **Show** options, search and filters as the Voices page.

![Select agent voice in the Configuration panel with the Show options, search, Dialect and Gender filters, and the voice list with Noura selected](https://mintcdn.com/hamsa-452fa79a/IyoYQ-nNrFRmlJOT/images/agents/settings/voice-picker-light.webp?fit=max\&auto=format\&n=IyoYQ-nNrFRmlJOT\&q=85\&s=3868d0cabc86602f8583665a3a998e2e)

**3. Pick a voice**

Select it. The agent's language becomes the voice's language (Arabic or English), and its speech dialect becomes the voice's dialect. There is no separate dialect control for the speech.

**4. Publish**

The voice is part of the agent's version. Callers hear the new voice only after it is published. See [Drafts and versions](https://docs.tryhamsa.com/agents/release/drafts-and-versions.md).

Under the voice, **Expressiveness** sets the voice's range, from **Stable** (a consistent sound) to **Expressive** (a more dynamic sound).

In a flow agent, a [Change settings step](https://docs.tryhamsa.com/agents/flow/steps/change-settings.md) can switch to another voice part way through a call.

## Manage voices

| Action | How | Who |
| - | - | - |
| Star a favorite | Click the star on a voice | Everyone who can see voices |
| Copy a voice's ID | Hover the row, click **Copy voice ID** | Everyone |
| Add a voice from a recording | **Add voice** | Owners and admins |
| Delete a project voice | Hover the row, click **Delete \{name}** | Owners and admins |

Members can browse, listen to, star and use every voice, but can't add or delete voices by default. An owner can change that in [Roles and permissions](https://docs.tryhamsa.com/overview/projects/roles-and-permissions.md).

Only project voices can be deleted. Voices from the catalogue can't be changed or deleted.

![A voice row on the Voices page with the pointer on the Copy voice ID button and its tooltip, next to the favorite star](https://mintcdn.com/hamsa-452fa79a/7GY0-8K2sfzXu6G7/images/agents/voices/voice-row-actions-light.webp?fit=max\&auto=format\&n=7GY0-8K2sfzXu6G7\&q=85\&s=1f8b5fccebe8eda66201d3e3effc3af6)

## Good to know

* There are no speed or stability controls; **Expressiveness** is the only voice control.
* Each Arabic voice has its own dialect. Pick a voice in your callers' dialect, for example a Gulf voice for callers in Saudi Arabia.
* If a word comes out wrong, fix it with a [pronunciation dictionary](https://docs.tryhamsa.com/agents/voices/dictionaries.md) rather than switching voices.

## Related

> [card] [Add a voice from a recording](https://docs.tryhamsa.com/agents/voices/add-a-voice.md)
>
> Clone a voice for your project.

> [card] [Pronunciation dictionaries](https://docs.tryhamsa.com/agents/voices/dictionaries.md)
>
> Fix how the agent says specific words.

> [card] [Voice, language and dialect](https://docs.tryhamsa.com/agents/settings/voice-and-language.md)
>
> The rest of the agent's voice settings.

> [card] [Drafts and versions](https://docs.tryhamsa.com/agents/release/drafts-and-versions.md)
>
> Publish a voice change so callers hear it.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.