> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pro.commure.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Dot Phrases

> Set up voice triggers that automatically expand into predefined text in your generated notes on your Android device.

<Note>
  This page is adapted from iOS documentation. Navigation paths and button labels may differ on Android. Hardware validation is pending.
</Note>

Dot Phrases let you create voice shortcuts that expand into longer text during note generation. When the AI detects your spoken trigger word during a recording, it automatically inserts the corresponding expanded phrase into the note.

## How It Works

A dot phrase pairs a **short audio cue** with a **predefined expanded phrase**.

**Example:**

* You say: **"belly"**
* The note writes: **"abdomen"**

## Creating a Dot Phrase

<Steps>
  <Step title="Open AI Studio">
    Navigate to **Settings** > **AI Studio** > **Dot Phrases**.
  </Step>

  <Step title="Add a new dot phrase">
    Tap **+ New Dot Phrase** at the bottom of the list, then enter the following:

    * **Audio Trigger** — the word you will speak during the encounter (short, distinctive, clearly pronounceable)
    * **Expanded Phrase** — the full text to insert into the note (up to 2,000 characters)
  </Step>

  <Step title="Assign to a template">
    Use the **Apply to Template** field to select one or more templates this dot phrase applies to. You can assign it to a single template or to all templates. Template-specific scoping prevents the phrase from triggering in unrelated note types.
  </Step>

  <Step title="Save">
    Tap **Save Dot Phrase** to confirm. The dot phrase is active for all future recordings using the assigned template.
  </Step>
</Steps>

## Expanded Phrase Formatting

The expanded phrase field supports several formatting options to create structured content:

* **Line breaks** — use `<br>` to insert line breaks within the expanded text
* **Headings** — use `###` markers to create section headings
* **Placeholders** — use `[[Insert Text]]` to mark areas where the AI should dynamically insert content based on the encounter
* **Smart tokens** — use tokens like `{home}` or `{snf}` to insert conditional content based on what is discussed during the visit (e.g., patient disposition)

## Managing Dot Phrases

From the Dot Phrases list, tap any existing phrase to edit its audio trigger, expanded phrase, or template assignment. To remove a dot phrase, open it and tap **Delete**.

<Warning>
  Deleting a dot phrase is irreversible. Removed phrases cannot be recovered and must be recreated from scratch.
</Warning>

## Best Practices

* **Use multi-syllable triggers** — short words like "a," "no," or "the" may trigger false positives
* **Be distinctive** — choose triggers that are unlikely to appear in normal conversation
* **Test before relying on them** — generate a test note to verify the phrase expands correctly

## Next Steps

<CardGroup cols={2}>
  <Card title="AI Studio" icon="sliders" href="/android/ambient_ai_scribe/ai-studio">
    Return to AI Studio to configure other note generation settings.
  </Card>

  <Card title="Custom Formatting" icon="pen-ruler" href="/android/ambient_ai_scribe/custom-formatting">
    Set per-template rules for tone, structure, and section formatting.
  </Card>

  <Card title="Macros" icon="code" href="/android/ambient_ai_scribe/custom-formatting#macros">
    Define reusable content that is automatically injected into note sections.
  </Card>
</CardGroup>