# Polly Voice Tag Attribute Details

## Voice Tag Attributes <a href="#voice_tag_attributes" id="voice_tag_attributes"></a>

### **\<gender>**

This attribute is not supported.

### **\<age>**

This attribute is not supported.

### **\<name>**

| Language                       | Name/ID           | Gender         | Standard Voice | Neural Voice |
| ------------------------------ | ----------------- | -------------- | -------------- | ------------ |
| Arabic (arb)                   | Zeina             | Female         | Yes            | No           |
| Chinese, Mandarin (cmn-CN)     | Zhiyu             | Female         | Yes            | No           |
| Danish (da-DK)                 | Naja              | Female         | Yes            | No           |
|                                | Mads              | Male           | Yes            | No           |
| Dutch (nl-NL)                  | Lotte             | Female         | Yes            | No           |
|                                | Ruben             | Male           | Yes            | No           |
| English (Australian) (en-AU)   | Nicole            | Female         | Yes            | No           |
|                                | Russell           | Male           | Yes            | No           |
| English (British) (en-GB)      | Amy               | Female         | Yes            | Yes          |
|                                | Emma              | Female         | Yes            | Yes          |
|                                | Brian             | Male           | Yes            | Yes          |
| English (Indian) (en-IN)       | Aditi\*           | Female         | Yes            | No           |
|                                | Raveena           | Female         | Yes            | No           |
| English (US) (en-US)           | Ivy               | Female (child) | Yes            | Yes          |
|                                | Joanna##          | Female         | Yes            | Yes          |
|                                | Kendra            | Female         | Yes            | Yes          |
|                                | Kimberly          | Female         | Yes            | Yes          |
|                                | Salli             | Female         | Yes            | Yes          |
|                                | Joey              | Male           | Yes            | Yes          |
|                                | Justin            | Male (child)   | Yes            | Yes          |
|                                | Matthew##         | Male           | Yes            | Yes          |
| English (Welsh) (en-GB-WLS)    | Geraint           | Male           | Yes            | No           |
| French (fr-FR)                 | Céline/Celine     | Female         | Yes            | No           |
|                                | Léa               | Female         | Yes            | No           |
|                                | Mathieu           | Male           | Yes            | No           |
| French (Canadian) (fr-CA)      | Chantal           | Female         | Yes            | No           |
| German (de-DE)                 | Marlene           | Female         | Yes            | No           |
|                                | Vicki             | Female         | Yes            | No           |
|                                | Hans              | Male           | Yes            | No           |
| Hindi (hi-IN)                  | Aditi\*           | Female         | Yes            | No           |
| Icelandic (is-IS)              | Dóra/Dora         | Female         | Yes            | No           |
|                                | Karl              | Male           | Yes            | No           |
| Italian (it-IT)                | Carla             | Female         | Yes            | No           |
|                                | Bianca            | Female         | Yes            | No           |
|                                | Giorgio           | Male           | Yes            | No           |
| Japanese (ja-JP)               | Mizuki            | Female         | Yes            | No           |
|                                | Takumi            | Male           | Yes            | No           |
| Korean (ko-KR)                 | Seoyeon           | Female         | Yes            | No           |
| Norwegian (nb-NO)              | Liv               | Female         | Yes            | No           |
| Polish (pl-PL)                 | Ewa               | Female         | Yes            | No           |
|                                | Maja              | Female         | Yes            | No           |
|                                | Jacek             | Male           | Yes            | No           |
|                                | Jan               | Male           | Yes            | No           |
| Portuguese (Brazilian) (pt-BR) | Camila            | Female         | Yes            | Yes          |
|                                | Vitória/Vitoria   | Female         | Yes            | No           |
|                                | Ricardo           | Male           | Yes            | No           |
| Portuguese (European) (pt-PT)  | Inês/Ines         | Female         | Yes            | No           |
|                                | Cristiano         | Male           | Yes            | No           |
| Romanian (ro-RO)               | Carmen            | Female         | Yes            | No           |
| Russian (ru-RU)                | Tatyana           | Female         | Yes            | No           |
|                                | Maxim             | Male           | Yes            | No           |
| Spanish (European) (es-ES)     | Conchita          | Female         | Yes            | No           |
|                                | Lucia             | Female         | Yes            | No           |
|                                | Enrique           | Male           | Yes            | No           |
| Spanish (Mexican) (es-MX)      | Mia               | Female         | Yes            | No           |
| Spanish (US) (es-US)           | Lupe              | Female         | Yes            | Yes          |
|                                | Penélope/Penelope | Female         | Yes            | No           |
|                                | Miguel            | Male           | Yes            | No           |
| Swedish (sv-SE)                | Astrid            | Female         | Yes            | No           |
| Turkish (tr-TR)                | Filiz             | Female         | Yes            | No           |
| Welsh (cy-GB)                  | Gwyneth           | Female         | Yes            | No           |

{% hint style="info" %}
**Notes**:&#x20;

\* This voice is bilingual and can speak both English and Hindi. For more information, see Bilingual Voices <https://docs.aws.amazon.com/polly/latest/dg/bilingual-voices.html>.

\## These voices can be used with both the Conversational and Newscaster speaking styles when used with the Neural format. For more information, see NTTS Speaking Styles <https://docs.aws.amazon.com/polly/latest/dg/ntts-speakingstyles.html>.

***Voice selection notes for Polly***\
\
If you specify the [Amazon Polly TTS](/dev/developer-reference/tts-engine-characteristics/amazon-polly-tts-engine.md), and neither a `<speak>` nor `<voice>` tag are specified, Plum Voice uses the en\_US, standard, female voice Joanna by default.<br>
{% endhint %}

### \<speak>

The \<speak> tag should be used to specify the desired language through the attribute xml:lang=”*lg-CN*”, where *lg-CN* is the language-country pair specified in the Language column from that table of supported languages here: <https://docs.aws.amazon.com/polly/latest/dg/voicelist.html>.

Please note that each voice has an associated language. Selecting a language that is not associated with the voice will result in unpredictable behavior; however, in many cases, you will hear the language the text was written in accented by that voice’s associated language.

### \<voice>

The \<voice> tag should be used to specify the desired voice through the attribute name=”*name*”, where *name* is the voice specified in the Name/ID column for the table of supported voices here: <https://docs.aws.amazon.com/polly/latest/dg/voicelist.html>.

If another voice is desired, it should specified using the `<speak>` and `<voice>` tags as follows within the prompt block:

```markup
<?xml version="1.0"?>
<vxml version="2.0">
 <form>
  <block>
   <prompt>
    <speak xml:lang="es-MX">
    <voice name="Mia" variant="1">
     Hello, thank you for calling Plum Voice.
    </voice>
    </speak>
   </prompt>
  </block>
 </form>
</vxml>
```

To sequentially use multiple languages and voices within a `<prompt>` block, use multiple `<speak>` and `<voice>` blocks. For example:

```markup
<?xml version="1.0"?>
<vxml version="2.0">
 <form>
  <block>
   <prompt>
    <speak xml:lang="en-US">
    <voice name="Joanna" variant="2">
     Press one to continue in English.
    </voice>
    </speak>
    <speak xml:lang="es-US">
    <voice name="Lupe" variant="2">
     Presione dos para continuar en español.
    </voice>
    </speak> 
    <speak xml:lang="fr-FR">
    <voice name="Celine" variant="standard">
     Appuyez sur trois pour continuer en français.
    </voice>
    </speak>
   </prompt>
  </block>
 </form>
</vxml>
```

### **\<xml:lang>**

This option is specified in the `<speak>` tag.

See the list of available languages in the [`<name>`](/dev/developer-reference/tts-engine-characteristics/amazon-polly-tts-engine/polly-voice-tag-attribute-details.md#less-than-name-greater-than) section.&#x20;

### SSML Tags

For more details on these SSML tags as they relate to Amazon Polly, please visit: <https://docs.aws.amazon.com/polly/latest/dg/supportedtags.html>.&#x20;

{% hint style="warning" %}
**Note** that Plum Voice does not currently support all the tags listed on Amazon's website. We may add support for additional tags in the future.
{% endhint %}

| Child Tag    | Amazon Polly |
| ------------ | ------------ |
| \<break>     |              |
| \<emphasis>  | x            |
| \<enumerate> |              |
| \<mark>      |              |
| \<paragraph> |              |
| \<phoneme>   | x            |
| \<prosody>   | x            |
| \<say-as>    | x            |
| \<sentence>  |              |
| \<speak>     |              |
| \<sub>       | x            |
| \<value>     |              |

### \<emphasis> <a href="#phoneme" id="phoneme"></a>

The `<emphasis>` tag lets you change the rate and volume of words and phrases.

For more information, consult: <https://docs.aws.amazon.com/polly/latest/dg/supportedtags.html#emphasis-tag>

### \<phoneme> <a href="#phoneme" id="phoneme"></a>

This tag lets you use phonetic pronunciation.&#x20;

For more information, consult: <https://docs.aws.amazon.com/polly/latest/dg/supportedtags.html#phoneme-tag>

### \<prosody> <a href="#prosody" id="prosody"></a>

The Amazon Polly engine provides granular control over volume, rate, and pitch. For detailed information about how to use this tag, consult <https://docs.aws.amazon.com/polly/latest/dg/supportedtags.html#prosody-tag>.

### \<say-as> <a href="#say-as" id="say-as"></a>

Polly enables you to control the way in which certain special words and phrases get spoken.

A full list is available here:

<https://docs.aws.amazon.com/polly/latest/dg/supportedtags.html#say-as-tag>

### \<sub> <a href="#sentence" id="sentence"></a>

This tag allows you to substitute a term or phrase for the selected text.

For more information, consult: <https://docs.aws.amazon.com/polly/latest/dg/supportedtags.html#sub-tag>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.plumvoice.com/dev/developer-reference/tts-engine-characteristics/amazon-polly-tts-engine/polly-voice-tag-attribute-details.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.