> 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/vocalizer-7.md).

# Vocalizer 7

{% hint style="warning" %}
**BETA FEATURE:**

The Vocalizer 7 TTS engine is currently available as a **beta feature**. Further testing and updates may take place while Vocalizer 7 is in beta.

We encourage you to share feedback at **<beta@plumgroup.com>**.
{% endhint %}

## Selecting the Vocalizer 7 TTS engine <a href="#voice_tag_attributes" id="voice_tag_attributes"></a>

In the toolbar menu, select **Applications**, then select **Application Configuration** in the dropdown menu. The Application Configuration page will be displayed.

A table of phone numbers and associated applications will be displayed on this page. Go to the desired phone number and select **Edit**. Configuration options for that phone number will be displayed as shown in Figure 1 below.

<figure><img src="/files/IHN3cALfg0L420OOb5QO" alt=""><figcaption><p>Figure 1: Selecting the Nuance Vocalizer 7 TTS engine.</p></figcaption></figure>

In the TTS engine dropdown menu, select **Nuance Vocalizer 7.0**. Make any additional selections as desired, then select **Save**.

## List of languages

Available voices currently cover the following languages:

<table><thead><tr><th width="284.89801699716713">Language</th><th width="170">Number of voices</th><th width="306">Multilingual voices</th></tr></thead><tbody><tr><td><strong>American English (en-US)</strong></td><td>9</td><td>2</td></tr><tr><td><strong>British English (en-GB)</strong></td><td>6</td><td><em>n/a</em></td></tr><tr><td><strong>Spanish (es-ES)</strong></td><td>4</td><td>1</td></tr><tr><td><strong>German (de-DE)</strong></td><td>5</td><td>1</td></tr><tr><td><strong>Canadian French (fr-CA)</strong></td><td>3</td><td>1</td></tr><tr><td><strong>French (fr-FR)</strong></td><td>3</td><td>1</td></tr><tr><td><strong>Brazilian Portuguese (pt-BR)</strong></td><td>3</td><td><em>n/a</em></td></tr><tr><td><strong>Portuguese (pt-PT)</strong></td><td>3</td><td><em>n/a</em></td></tr><tr><td><strong>Cantonese (zh-HK)</strong></td><td>2</td><td>2</td></tr><tr><td><strong>Mandarin (zh-CN)</strong></td><td>2</td><td>2</td></tr></tbody></table>

For more details on voices, see [Vocalizer 7: \<voice> tag and SSML Support](/dev/developer-reference/tts-engine-characteristics/vocalizer-7/vocalizer-7-less-than-voice-greater-than-tag-and-ssml-support.md#name).

## SSML 1.0 support

Vocalizer supports the majority of the W3C specification SSML 1.0 for further VXML markup. See [Vocalizer 7: \<voice> tag and SSML Support](/dev/developer-reference/tts-engine-characteristics/vocalizer-7/vocalizer-7-less-than-voice-greater-than-tag-and-ssml-support.md) for more information.

## Recommended best practices

### Avoid using `xml:lang` in `<voice>`

When setting the TTS language, avoid using the `xml:lang` attribute in the `<voice>` tag. Vocalizer 7 does not accept it. It will cause the TTS engine to use the default voice instead of the one specified.

Instead, use the `xml:lang` attribute of the `<speak>` or `<vxml>` tags.&#x20;

#### Do this:

`<speak>` tag using the `xml:lang` attribute to specify British English:

```xml
<block>
    <prompt>
        <speak xml:lang="en-GB">
            <voice name="malcolm">
                Thank you for calling.
            </voice>
        </speak>
    </prompt>
</block>
```

`<vxml>` tag using the `xml:lang` attribute to specify British English:

```xml
<vxml version="2.1" xml:lang="en-GB">
    <form id="main">
        <block>
            <prompt>
                Thank you for calling.
            </prompt>
        </block>
    </form>
</vxml>
```

The above examples will use the voices and languages specified.

#### Don't do this:

Faulty method using `xml:lang` in the `<voice>` tag.

```xml
<block>
    <prompt>
        <voice name="malcolm" xml:lang="en-GB">
            Block 4.
        </voice>
    </prompt>
</block>
```

In the above example, Vocalizer would fail to accept the specified voice and would fall back to the default voice instead.

### Note `bargein` effects on prompt queueing behavior

If `bargein` is enabled (i.e., `<prompt bargein="true"`) in a series of prompts in a row, you may experience some delay before the first prompt starts playing. It has been reported that this behavior may be more apparent with Vocalizer 7 than with other TTS engines.

For more details on prompts and barge-in, see [Audio Formats and Prompts](https://docs.plumvoice.com/dev/developer-reference/audio-formats-and-prompts#prompt_queuing_and_barge-in_behavior).