> ## Documentation Index
> Fetch the complete documentation index at: https://q.odontox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# SOAP Review & Voice Notes

> Convert voice dictation or typed clinical observations into structured SOAP notes with AI-powered formatting, multi-language translation, and patient pre-fill.

The SOAP Review panel lets you create structured clinical notes from free-form voice dictation or typed text. Instead of manually filling in each SOAP field, you describe what happened during the appointment and the AI organizes it into the correct clinical structure.

**Doctors** use SOAP Review.

<video autoPlay muted loop playsInline style={{ borderRadius: '0.5rem', width: '100%' }}>
  <source src="https://assets.odontox.io/odontox-prod-asset/ai-notes-soap.mov" type="video/mp4" />
</video>

## How it works

<Steps>
  <Step title="Open the SOAP Review panel">
    Navigate to the full-page SOAP Review panel from the clinical notes area of an appointment.
  </Step>

  <Step title="Choose your input method">
    You can either type your clinical observations directly into the text area, or use the voice recorder to dictate them.
  </Step>

  <Step title="Select your language (voice only)">
    If using voice dictation, select your language before you start recording. Supported languages are **English**, **Urdu**, and **Hindi**.
  </Step>

  <Step title="Record or type your observations">
    Describe what happened during the appointment in your own words. Include the chief complaint, what you found on examination, your assessment, and your plan.
  </Step>

  <Step title="Click 'Structure with AI'">
    The AI processes your input and populates the structured SOAP fields.
  </Step>

  <Step title="Review and edit">
    Check every field before saving. Edit anything that needs adjustment.
  </Step>
</Steps>

## Structured output fields

The AI organizes your input into the following fields:

| Field                  | What it captures                                      |
| ---------------------- | ----------------------------------------------------- |
| **Chief Complaint**    | The patient's primary reason for the visit            |
| **Subjective**         | Patient-reported symptoms, history, and concerns      |
| **Objective**          | Your clinical findings and examination results        |
| **Assessment**         | Your diagnosis or differential diagnosis              |
| **Plan**               | Treatment plan, prescriptions, follow-up instructions |
| **Diagnosis**          | Formal diagnosis for the record                       |
| **Treatment Provided** | Procedures performed during this visit                |

## Voice dictation

The voice recorder supports three languages for transcription:

* **English** — direct transcription
* **Urdu** — transcribed and automatically translated to clinical English
* **Hindi** — transcribed and automatically translated to clinical English

<Tip>
  Select your language before pressing the record button. A pulsing animation confirms the recorder is actively processing your speech.
</Tip>

When you dictate in Urdu, the system transcribes your speech and then translates it into clinical English for the structured output. This means your SOAP note will always be in English regardless of the language you dictate in.

## Key behaviors

<AccordionGroup>
  <Accordion title="Sparse input produces sparse output">
    The AI never fabricates clinical findings. If you only mention a chief complaint and a plan, the Objective and Assessment fields will remain minimal or empty. This is intentional — what you don't say doesn't get invented.
  </Accordion>

  <Accordion title="Automatic FDI notation">
    Tooth numbers mentioned in your dictation are automatically converted to FDI (Federation Dentaire Internationale) notation in the structured output. Whether you say "upper right six" or "tooth 16", the output uses the standard two-digit format.
  </Accordion>

  <Accordion title="Error handling">
    If something goes wrong during processing, a retry button appears. You won't lose your original input — simply click retry to try again.
  </Accordion>
</AccordionGroup>

<Warning>
  Each SOAP review generation counts toward your **15 generations per day** rate limit, shared across all Ruby features. Routine page loads don't count — only an explicit Refresh or Generate does.
</Warning>

## Tips for better results

<CardGroup cols={2}>
  <Card title="Be specific about findings">
    Instead of "tooth looks bad," say "tooth 36 has deep caries on the mesial surface with pulp exposure."
  </Card>

  <Card title="Mention your plan explicitly">
    The AI separates assessment from plan, so stating both clearly helps produce accurate structure.
  </Card>

  <Card title="Include patient-reported details">
    Mention what the patient told you — pain duration, sensitivity triggers, medication history — so the Subjective field is populated.
  </Card>

  <Card title="Speak naturally">
    You don't need to dictate in SOAP order. The AI will sort your observations into the correct fields regardless of the order you mention them.
  </Card>
</CardGroup>

<Note>
  Always review the structured output before saving. The AI is a drafting tool — the clinical record is your responsibility.
</Note>

## Related articles

* [AI Overview](/ai/overview) — rate limits, AI principles, and the full list of AI features
* [Note Editing Tools](/ai/note-tools) — polish, shorten, or expand notes after structuring
* [Patient Brief](/ai/patient-brief) — quick clinical summary before appointments