> For the complete documentation index, see [llms.txt](https://docs.plumvoice.com/dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.plumvoice.com/dev/developer-reference/tts-engine-characteristics/amazon-polly-tts-engine/polly-voice-tag-attribute-details.md).

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