> For the complete documentation index, see [llms.txt](https://docs.siminsights.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.siminsights.com/hyperskill-studio-authoring/state-machine-reference/actions/display-message.md).

# Display Message

Display Message shows a message to the user and can optionally speak it.

1. Within the edit Simulation section of the HyperSkill Desktop application, navigate to the State Machine tab.
2. Click on the desired state and, from the dropdown in either the entry or exit actions, select the type Display Message.
3. Press the + button to add the action to the action list.

<figure><img src="https://2704613365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxYaaXoZ4YGbVdAnAhdcE%2Fuploads%2FVFKwRLcdIIZgCd3PiNHk%2F112.png?alt=media&#x26;token=04e5cd0a-734a-4a2b-8675-021c5293772e" alt=""><figcaption></figcaption></figure>

4. Enter the message you want to display in the text field.
5. Choose a **Display Type**: **Display Only** shows the message as text, **Spoken Only** speaks it without showing text, and **Display and Spoken** does both.
6. If you chose **Spoken Only** or **Display and Spoken**, the voice settings appear. Choose the voice that speaks the message. With **Display Only** these fields are hidden.

## Voice settings

These fields appear only when **Display Type** is **Spoken Only** or **Display and Spoken**:

* **Audio Output Type:** **Text to Speech** generates the audio.
* **Voice:** The list of voices available for generation.
* **Custom voice ID:** A text field for entering a custom voice ID. Custom voice IDs work with both ElevenLabs and Google Text-to-Speech.

**Note:** If the message is spoken, the state machine does not move on to the next action in the sequence (if there are multiple) until the system has finished speaking the message.