> ## 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.

# Voice Settings

> Configure the voice, language, and dialect for your single prompt agent

## Overview

Voice settings control how your agent sounds during calls. You can choose from Hamsa's library of AI voices, filter by language, dialect, gender, and style, and preview voices before selecting one.

## Accessing Voice Settings

1. Open your Single Prompt Agent
2. Expand the **Configuration** panel
3. Click **Voice Settings** to expand the section
4. Click **Change** to open the voice selector

## Voice Library

The voice selector is organized into four tabs:

* **All Voices** — Complete library of available voices
* **Favorite Voices** — Voices you've starred
* **Currently Used** — Voices recently used across your agents
* **My Voices** — Custom voices created via voice cloning

## Filters

Use filters to narrow down the library:

**Language** — Select **English** or **Arabic**. Voices are language-specific; always match the voice language to your agent's conversation language.

**Gender** — Filter by **Male**, **Female**, or show all.

**Dialect** — Available for Arabic only. Options include Egyptian (EGY), Saudi Arabian (KSA), Emirati (UAE), Jordanian (JOR), Lebanese (LEB), Syrian (SYR), Palestinian (PLS), Iraqi (IRQ), and Bahraini (BAH). English does not have dialect sub-filters.

**Style** — Filter by **Conversational** (natural, everyday tone) or **Narrator** (clear, broadcast-style delivery).

**Search** — Type a voice name to filter in real time.

Click **Clear Filters** to reset.

## Previewing and Selecting a Voice

1. Click the **Play** button on any voice card to hear a sample
2. Click the voice card to select it
3. Click **Save** to apply

<Warning>
  Preview samples are short clips. Always test your chosen voice in a real call using the Test Agent feature before going live.
</Warning>

## Managing Voices

**Favorites** — Click the star icon on a voice card to add it to your Favorite Voices tab for quick access.

**Copy Voice ID / Name** — Hover over a voice card, click the actions menu (⋯), and select **Copy ID** or **Copy Name**. Voice IDs are useful for API integrations.

## Voice Cloning

You can create a custom branded voice and use it like any other voice in the library. See [Voice Cloning](/overview/features/voice-cloning) for details.

## Expressiveness

Controls the emotional range and variation of the voice.

**Range:** 0.0–2.0 (slider from Stable to Expressive)
**Default:** 1.0

Lower values produce more stable, consistent speech. Higher values add more emotional variation and emphasis.

## Voice Dictionaries

Attach pronunciation dictionaries for specialized terms — brand names, technical jargon, foreign words, or any term the default voice may mispronounce.

Dictionaries are created and managed in the **Voices → Dictionaries** section, then selected here in Voice Settings. Click **Manage Dictionaries** to open the dictionaries page.

## STT Model

Select the speech-to-text model for transcription.

| Model                      | Description                              |
| -------------------------- | ---------------------------------------- |
| **Hamsa-STT-S2** (default) | Stable Arabic/English recognition        |
| **Hamsa-STT-S3-beta**      | Most recent model, faster Arabic/English |
| **Hamsa-STT-English**      | English-focused recognition              |

Selecting **Hamsa-STT-English** automatically sets the user language to English. The other models support multilingual recognition.

## Language and Dialect Switcher

The Language Dialect Switcher (enabled in **Call Settings**) adapts speech recognition to the caller's Arabic dialect, even if your agent is configured with a different Arabic dialect. For example, an agent configured with Egyptian Arabic can better understand a caller speaking Gulf Arabic when this is enabled.

This feature is designed for Arabic dialect variation. English operates with a single general speech recognition model.

## Troubleshooting

**Voice sounds robotic or unnatural** — Try a different voice. Make sure the voice language matches the agent's conversation language.

**Voice is too fast or slow** — Speed is a characteristic of the voice itself and is not configurable. Try a different voice, or adjust sentence length in your prompt to influence pacing.

**Voice sounds different in production vs preview** — Always test via Test Agent rather than relying on preview clips alone.

**Can't find a previously used voice** — Check the **Currently Used** tab, or search by name.

## Next Steps

<CardGroup cols={2}>
  <Card title="Call Behavior Settings" href="./call-behavior">
    Configure response timing, interruptions, and timeouts
  </Card>

  <Card title="Intelligence Features" href="./intelligence-features">
    Enable gender detection, smart call end, and more
  </Card>

  <Card title="LLM Configuration" href="/overview/features/llm-configuration">
    Configure the AI model and temperature
  </Card>

  <Card title="Voice Cloning" href="/overview/features/voice-cloning">
    Create a custom branded voice
  </Card>
</CardGroup>