ZenotiHelp

Configure dot phrases

ZTZenoti Docs Team Updated September 4, 2026 5 min readHow-to

Dot phrases are text shortcuts that allow providers to insert pre-defined text, phrases, or paragraphs into form fields during form filling. Instead of typing repetitive text manually, a provider types a period (.) followed by a short code, and the system expands it into the full text. Dot phrases are especially useful in clinical settings where providers need to enter standardized notes and observations.

Note: For conceptual background, see Forms overview.


On this page


Before you begin

  • The Enable dot phrases toggle must be switched on at Configuration > Business details > Business setup > Features. Until it is on, the Dot phrases section does not appear under Configuration > Forms.
  • Decide whether each dot phrase should be private (visible only to the creator) or shared (visible to all authorized users).

Permission: Add under DotPhrases in the Administrator section of the security role β€” Required to create new dot phrases.

Permission: Edit under DotPhrases in the Administrator section of the security role β€” Required to modify existing dot phrases.

How dot phrases work

During form filling, a provider types a period (.) followed by a dot phrase code in a text area (multi-line text field) within a form built using the modern form builder. The system searches for matching dot phrases and displays a list of suggestions. The provider selects a suggestion, and the system replaces the typed code with the full expanded text.

For example, if a dot phrase with code bp has the predefined note "Blood pressure: Within normal range. No abnormalities noted.", the provider types .bp in a text area and selects the suggestion. The system inserts the full text.

Note: Dot phrases are available in text area fields (multi-line inputs such as Treatment Notes or Comments). They are not available in text fields (single-line inputs such as Practitioner Name or service fields). The dot phrase trigger (.code) requires a multi-line field to display the suggestion picker.

Note: The inline auto-complete picker for dot phrases is available primarily in forms built with the modern form builder. Legacy (HTML-based) forms display any pre-filled dot phrase text but do not provide the in-field picker while typing.

Use a dot phrase during form filling

  1. Open a form in the form view (during an appointment, at the kiosk, or on the Webstore).
  2. Place your cursor in any text field.
  3. Type a period (.) followed by the dot phrase code (for example, .bp).
  4. As you type, the system displays a suggestion list matching your input.
  5. Select the suggestion from the list. The system replaces the typed code with the full expanded text.
  6. Continue editing the field as needed.

Tip: If multiple dot phrases start with the same letters, the suggestion list narrows as you type additional characters. Short, memorable codes (2–4 characters) work best.

Video: Forms - Dot Phrases - Introduction (1:29) β€” Overview of the dot phrases feature and how it speeds up form filling.

Video: Forms - Dot Phrases - Setup (1:40) β€” Walk-through of creating and managing dot phrases.

Create a dot phrase

  1. Navigate to Configuration > Forms > Dot phrases.

  2. Click the option to add a new dot phrase.

  3. Enter the dot phrase details:

    Field Description
    Dot Phrase A descriptive name for the dot phrase. This appears in the suggestion list to help providers identify the correct phrase.
    Description A short description of when to use the dot phrase.
    Code The short text code that triggers the dot phrase. Providers type a period followed by this code during form filling. Use a brief, memorable code (for example, bp, hpi, ros). Letters, numbers, and hyphens only β€” special characters and spaces are not permitted.
    Predefined notes The expanded text that replaces the code when the provider selects the suggestion. This can be a word, sentence, or full paragraph. Special characters are permitted in the expanded text.
    Private When enabled, only you (the creator) can see and use this dot phrase. When disabled, the dot phrase is shared and available to all authorized users in the organization.
  4. Click Save.

Manage dot phrases

The dot phrases management page displays all dot phrases in a paginated, searchable grid with the columns code, dot Phrase, Description, Predefined notes, and Edited by.

  1. Navigate to Configuration > Forms > Dot phrases.
  2. Use the search bar ("Code, Dot phrase, Description, Predefined notes") and click Search to find a dot phrase.
  3. Click a dot phrase to edit its details.
  4. You can edit the predefined notes directly in the grid for quick updates without opening the full edit page.
  5. To delete a dot phrase, select it and click Delete.

Private and shared dot phrases

Type Visibility Use case
Private Only the user who created the dot phrase can see and use it. Personal shortcuts for individual providers who have their own preferred phrasing.
Shared All authorized users in the organization can see and use the dot phrase. Standardized clinical notes, organizational templates, or common observations.

When a provider types a dot phrase code during form filling, the system searches both their private dot phrases and all shared dot phrases to generate suggestions.

Multi-level configuration

Dot phrases support multi-level configuration, allowing you to set organization-wide defaults and override them at the zone or center level.

Level Description
Organization Dot phrases created at the organization level are available across all centers unless overridden.
Zone Dot phrases created at the zone level override organization-level phrases for all centers in that zone.
Center Dot phrases created at the center level override both organization and zone-level phrases for that specific center.

This hierarchy lets you maintain a standard set of dot phrases across the organization while allowing individual centers to customize phrases for their specific needs.

To configure dot phrases at a specific level:

  1. Navigate to Configuration > Forms > Dot phrases.
  2. Select the configuration level (organization, zone, or center) using the level selector.
  3. Create, edit, or delete dot phrases for the selected level.
Was this article helpful?
Your feedback helps us improve our documentation.