---
title: "text to speech · RUAL Documentation"
description: "Speaks the given text in a browser-controlled voice."
canonical: https://docs.rual.nl/block-types/UI/uicomponent_text_to_speech
language: en
---

# text to speech

This block is part of the [`ui`](https://docs.rual.nl/block-types/ui) group and was last modified in core [`v12.0.5`](https://docs.rual.nl/core-versions/120005).

Speaks the given text in a browser-controlled voice.

- flow `flow`

- text required `value` The text to speak, use commas to improve the way the text is spoken

- language `value` A value representing a BCP 47 language tag (`en-EN`, `nl-NL`, etc).

Default `browser language`

- rate `number` A float representing the rate value. It can range between 0.1 (lowest) and 10 (highest), with 1 being the default pitch for the current platform or voice, which should correspond to a normal speaking rate. Other values act as a percentage relative to this, so for example 2 is twice as fast, 0.5 is half as fast, etc.

Default `1`

- flow `flow`

| `speak` |
| --- |

A typical wiring for [text to speech](https://docs.rual.nl/block-types/UI/uicomponent_text_to_speech): a [function trigger](https://docs.rual.nl/block-types/globals/trigger_custom_function) starts the flow; [value](https://docs.rual.nl/block-types/value/value_default) feeds the `text` pin; the `flow` out pin feeds [debug](https://docs.rual.nl/block-types/state%20ui/state_debug).

![Studio canvas example for the text to speech block: typical wiring for text to speech.](https://docs.rual.nl/canvas-examples/uicomponent_text_to_speech.png)

### Version history

Introduced in [`v12.0.5`](https://docs.rual.nl/core-versions/120005).