Text blocks and tap actions

Use a Text block for written instructions, formatted information, and optional images within the text. It can also run an action when tapped. It does not collect an answer; use a Field block for responses.

You need edit access to the Guide's Library folder and a workspace that allows authoring.

Add or edit text

1. Open the Guide in the editor, select the page, and choose Add block > Text, or select Edit on an existing Text block.
2. Use the pencil beside its name to give it a useful name; confirm the name with the checkmark.
3. Write Text content in the rich-text editor.
4. Choose text appearance, Card, Speech, or On tap settings as needed.
5. Select Save block, wait for confirmation, then Preview.

The name and content are separate. Naming a block does not provide its visible instructions. Empty content produces a severe Guide warning.

Use rich-text formatting for headings, lists, links, tables, and Source editing. Source changes can simplify formatting; review the warning before enabling them. Inline images need their own upload or copy to finish before Save block is available.

An image-only rich-text block can render without written sentences, but empty-content warnings can still depend on its text representation. Add useful words when the image needs explanation.

Set presentation and wording

Text size offers Small, Body, Large, and Heading. Text alignment and Text color can follow the player's defaults or use explicit choices. Card controls the surrounding surface and block position. See Block appearance.

When available, Do not adapt / show verbatim keeps this block's authored visual and generated-speech wording unchanged by communication adaptation. Recorded and uploaded audio is preserved independently. See communication preferences.

Add an On tap action

Leave On tap as None for ordinary information. Otherwise choose an outcome, such as a page destination, Popup Page, message, speech, or a Guide ending. Complete its required destination or wording and review its timing.

The choices use the same destination and timing concepts described in page outcomes, but run when the player activates this block. For a Text tap's Speak action, enter the words to speak; it does not automatically take the block's content.

Complete every required outcome field before saving. An incomplete outcome edit can leave the previous valid action in place. Reopen the saved block and verify On tap, then test it in Preview and normal Play.

During playback, tapping the text activates the action. Its keyboard-accessible action can also be focused and activated. Links and other embedded controls keep their own behavior, and selecting text does not trigger the tap action. The authoring editor does not run it while you edit.

A delayed action applies only while its playback context remains current. Navigation and completion can also be blocked by required answers in Play. Use navigation locks and required answers to check the complete path.

Provide spoken support

In Speech, review the current speech source and any Spoken text override, custom audio, Cloud voice, accessibility label, and hint. Default Text speech uses the written content without automatically reading image descriptions. Provide explanatory words or an override for images that need narration.

Updating visible text does not rewrite a custom override or recording. Review those when instructions change. A Cloud voice binding saves separately from Save block; see Guide speech.

If content is missing, reopen Text content and inspect it. If an action points to a removed page, choose a valid destination and save again. If saving stalls after an image operation, finish it or use its Retry/Cancel controls before following save recovery.