> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.synthesia.io/docs/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.synthesia.io/docs/_mcp/server.

# Script supported XML tags

Synthesia API scripts support a set of HTML-like tags that let you control timing and pronunciation in generated videos.

## Quick Reference

| Tag       | Purpose               | Example                                    |
| --------- | --------------------- | ------------------------------------------ |
| `<break>` | Insert a pause        | `Hello <break time="2s"/> world`           |
| `<sub>`   | Control pronunciation | `<sub alias="Syn-the-zia">Synthesia</sub>` |

\


## Insert Pauses with `<break>`

Use the `<break>` tag to add pauses or delays in narration:

* The `time` attribute accepts seconds (`s`) .
* Works with all voices.

**Syntax:**

```html
<break time="1s"/>
```

**Example:**

```text
Hello <break time="2s"/> world
```

## Control Pronunciation with `<sub>`

Use the `<sub>` tag to make the avatar say one word while displaying another as on-screen text:

* `alias` is what the avatar says.
* Inner text is what shows as captions.
* Behaves the same way as [SSML `sub`](https://www.w3.org/TR/speech-synthesis11/#S3.1.10).

**Syntax:**

```html
<sub alias="spoken text">caption text</sub>
```

**Example:**

```text
The word is <sub alias="Syn-the-zia">Synthesia</sub>
```