> ## 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.

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="/apple/ambient_ai_scribe/ai-studio">
    Return to AI Studio to configure other note generation settings.
  </Card>

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

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