ZenotiHelp

Use forms in appointments

ZTZenoti Docs Team Updated October 26, 2026 19 min readGuide

Filling and submitting forms is the core day-to-day workflow for capturing service data during appointments. Providers open the form view for an appointment, fill in the required fields, and submit the completed form. Zenoti supports auto-populated data through macros, text shortcuts through dot phrases, and auto-save. Providers can also annotate images, upload files, and use AI-powered form filling where enabled.

Note: For conceptual background on form types, statuses, and versioning, see Forms overview.


On this page


Audience: Providers and front desk staff who fill, submit, and manage forms during appointments.

Before you begin

  • The appointment must have at least one form associated with its service. See Forms overview for how form-service associations work.
  • You need the following permissions:

Permission: Edit under ServiceCustomData in the Appointment Book section of the security role β€” Required to fill and submit service forms during appointments.

Permission: Unlock Forms under ServiceCustomData in the Appointment Book section of the security role β€” Required to unlock a submitted form for re-editing.

Steps

Fill a service form during an appointment

  1. Open the appointment in the Appointment Book.
  2. Navigate to the Forms tab to view all forms associated with the service.
  3. Select the form you want to fill. The system displays the form with any pre-populated fields.
  4. Complete the required and optional fields.
  5. Click Submit to submit the form, or click Save to save your progress as a draft.

The system retrieves forms based on the service association, the visit mode (first visit, subsequent visit, or all visits), and any dynamic forms added to the appointment.

Important: For forms configured in subsequent visit mode, the form appears in the Consent Forms tab on the guest profile, not within the service block on the appointment. This is different from first-visit forms, which appear directly in the appointment's service section. If you cannot find a subsequent visit form in the appointment view, look under the guest profile's Consent Forms tab.

Open service forms from the appointment action menu

The appointment action menu provides quick access to service forms without navigating to the Forms tab. The menu includes up to three service-form entries. Their exact labels depend on the term your organization has configured for service forms β€” the entries use your organization's own term in place of the placeholder shown here as {term}. All three entries are built from the same organization-configured term, so changing that term rewords all three entries simultaneously. The entries cannot be renamed individually.

The three entries appear in this fixed sequence in the menu:

  1. Enter {term} or Show {term} β€” Opens the form for data entry or viewing. The label shows Enter {term} when the form has not yet been filled, and switches to Show {term} once the form has been filled or when the appointment is in a paid status and your organization has disabled editing of service forms after invoice closure.
  2. Send {guest form} Link β€” Sends the guest a link to complete a guest form (this entry relates to guest forms, not service forms).
  3. Send {term} Link β€” Queues an email to the guest containing a link to the service form. Selecting this entry does not open the form in place β€” it sends the link only. If the guest has no email address on file, the system displays an alert instead of sending the message.

Important: Two of the three entries begin with "Send", and they appear adjacent to each other in the menu. Before selecting an entry, confirm whether you intend to open the form locally or send a link to the guest. Select Enter {term} or Show {term} to open the form locally; select Send {term} Link only when you want to email a form link to the guest.

Note: To update the term used across all three entries, go to Configuration > Forms and adjust the service form label setting.

Macro substitution

When a form loads, Zenoti automatically populates certain fields with data from the appointment context. This is called macro substitution. The system resolves macros before rendering the form, so you see the actual values when the form opens.

You do not need to manually enter data that macros already populate. The form displays the resolved values when it loads.

Which macros resolve depends on the form type. As an example, a service form on a guest appointment can resolve guest, center, service, and custom macros (for example, GuestFirstName, CenterName, ServiceName); a membership form additionally resolves membership macros; an invoice context adds invoice macros.

Note: The full macro catalog β€” every supported macro by category, plus the rules for which macros resolve in which form types β€” is maintained in Use macros in forms. Refer to that article for the authoritative list.

Use dot phrases during form fill

Dot phrases are text shortcuts that expand into longer text when you type them. They help you fill forms faster by replacing repetitive text entry with short codes.

  1. Place your cursor in a text field within the form.
  2. Type a period (.) followed by the dot phrase code. For example, type .bp if you have a dot phrase with the code bp.
  3. The system displays a list of matching dot phrases as you type.
  4. Select the dot phrase you want. The expanded text replaces the shortcut code in the field.

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.

Save as draft vs. submit

You have two options when completing a form:

  • Save as draft β€” Saves your current progress without finalizing the form. You can return to the form later to continue editing. The form fill status changes to Saved.
  • Submit β€” Finalizes the form and locks it based on the editing restriction settings. The form fill status changes to Submitted. If the form has the Require review flag enabled, it enters the review queue.

Save your work frequently when filling long forms. If auto-save is enabled, the system saves your progress periodically.

Form locking and editing restrictions

After you submit a form, the system may lock it based on your organization's editing restriction setting. Four restriction modes are available:

Restriction mode Behavior
Restrict after closing invoice The form is locked once the appointment invoice is closed. You can edit the form until the invoice is closed.
Restrict after form submission The form is locked immediately after submission. You cannot edit the form once submitted.
Restrict after submission or service date passed The form is locked after submission or after the service date has passed, whichever comes first.
No restriction (default) The form remains editable at all times, regardless of submission or invoice status.

When a form is locked, the input fields are disabled and the save option is hidden. To edit a locked form, a user with the unlock permission must unlock it first. See Manage form reviews for details on unlocking forms.

What happens when you save a submitted form as a draft

Under the No restriction (default) editing mode, a form that has already been submitted remains fully editable β€” no unlock step is required. This means that if you re-open a submitted form and save it as a draft, the system moves the form's fill status backward from Submitted to Saved without showing a warning or asking for confirmation.

The following changes take effect when a submitted form is saved as a draft:

  • The form fill status changes from Submitted back to Saved.
  • If the form had previously been marked as reviewed, that review state is cleared. The form must be re-submitted and must go through the review workflow again before it can be marked as reviewed.

Important: Under the other restriction modes (Restrict after form submission, Restrict after closing invoice, and Restrict after submission or service date passed), the form is locked after submission. Re-opening and re-saving the form as a draft is only possible after a user with the Unlock Forms permission has unlocked the form. This explicit unlock step makes the backward status transition visible and intentional.

The form activity log and backward transitions

Each form action β€” including opening the form, saving as a draft, and submitting β€” is recorded as a separate entry in the form activity log. When you save a submitted form as a draft, the log appends a new SavedAsDraft entry. The earlier Submitted entry remains in the log and is never removed or overwritten.

This means the activity log shows the complete interaction history of the form, including all forward and backward status transitions. The log is the reliable record of what happened, even when the current visible form fill status has moved backward to Saved.

Tip: If there is any question about whether a form was previously submitted, check the form activity log. A Submitted entry in the log confirms the form was submitted at some point, even if the current status shows Saved.

Form fill statuses

Each form associated with an appointment has one of four fill statuses:

Status Description
NoForm No form is associated with the service for this appointment.
NotFilled A form is associated but has not been opened or started.
Saved The form has been saved as a draft. Some fields may still be incomplete.
Submitted The form has been submitted and finalized.

These statuses appear in the appointment form view and in the service forms report.

Switch to a new form version

When an administrator publishes a new version of a form, the system detects the update and notifies you when you open the form.

  1. Open the form for the appointment. If a new version is available, the system displays a notification.
  2. Choose whether to switch to the new version or continue with the current version.
  3. If you switch, the system loads the new form version. Any previously saved draft data on the old version may not carry over.

Important: If your organization requires the latest form version, the system automatically loads the newest version without giving you the option to use the older one.

Auto-save behavior

When auto-save is enabled for your organization, the system periodically saves your form progress in the background. This prevents data loss if your session is interrupted or you navigate away from the form.

Auto-saved data is stored securely and retrieved the next time you open the form. If you have auto-saved data and also a manually saved draft, the system uses the most recent version.

Image annotations

For forms that include image-type fields, you can draw annotations directly on images.

  1. Open the image field in the form.
  2. Use the annotation tools to draw shapes, add text overlays, or mark areas of interest on the image.
  3. Save or submit the form to store your annotations with the form data.

Image annotations are useful for clinical documentation, marking treatment areas, or highlighting specific details on diagrams and photos.

File uploads in forms

Forms can include file upload fields that allow you to attach documents, images, or other files.

  1. Click the file upload field in the form.
  2. Select the file you want to upload from your device.

Note: The system uploads the file and attaches it to the form.

Maximum file sizes are configured by your organization. V3 forms support inline image uploads that are stored securely.

Unified form view

The unified form view displays all forms (service forms, tag forms, and guest forms) for a given time range, center, and provider in a single consolidated view.

  1. Navigate to the unified form view.
  2. Select the date range, center, and provider to filter the forms.

Note: The system displays all matching forms with pagination. You can open any form to view or edit it.

This view helps providers and reviewers see all form activity in one place rather than navigating through individual appointments.

When an appointment has multiple forms associated with it (for example, a service form, a tag form, and a consent form), the modern form builder presents them in a single layout that lets you move between forms without leaving the appointment context.

  1. Open the appointment and navigate to the Forms tab.
  2. The system lists all associated forms. Each form appears as a tab in the form-tab rail at the top of the form view, with its name and current fill status badge (NotFilled / Saved / Submitted).
  3. Select a tab to open the form. The header for the active form stays pinned (sticky) at the top so the form name, fill status, and Save / Submit controls remain visible while you scroll through long forms.
  4. Use the keyboard shortcut Ctrl+S (or Cmd+S on macOS) to save the current form as a draft without leaving the tab. The system shows a brief saved-confirmation indicator.
  5. Move between forms by selecting a different tab in the rail. Unsaved changes in the active form prompt a confirmation before the system switches tabs.
  6. After you have completed the last form, the appointment indicator updates to show all required forms are submitted.

The order of tabs in the rail is determined by the form-service association configuration. Forms are grouped by type: service forms appear first, followed by tag forms, then any dynamic forms added at appointment time. Within each group, forms follow the display-order setting on each form-service association.

When you have a form open for a guest, you can jump directly to any other form associated with that guest β€” across all their appointments β€” without closing the current form and returning to the guest profile.

  1. While viewing an open form, hover over or tap the Go to form list (displayed in the form header or navigation bar).
  2. The list shows all other forms linked to this guest, organized by appointment date and form type.
  3. Select the form you want to open. The system loads that form in context.

This shortcut is useful when reviewing a guest's treatment history across multiple visits, or when you need to cross-reference an earlier consent form while filling a current one.

Note: The Unified Forms View tab on the guest profile (also labelled according to your organization's custom label for that tab) provides the same cross-appointment form access from the guest profile level. The label for this tab varies if your organization has configured a custom label under Configuration > Forms (the "Enter label for unified form" setting).

Use the v1 digital form data entry view

A small set of organizations still maintains v1 (KeyValuePair) digital forms β€” typically older intake forms or compliance documents that have not yet been migrated to the modern form builder. The v1 entry view is a flat list of label/value pairs without the styling, macros, or dot-phrase auto-complete of the modern builder.

  1. Open the appointment and navigate to the Forms tab.
  2. If a v1 digital form is associated with the service, the system labels it explicitly so you can distinguish it from modern-builder forms.
  3. Open the v1 form. Each captured field appears as a label followed by an input.
  4. Enter the values and click Submit. The submitted data flows into the same compliance and reporting pipeline as forms built with the modern builder.

Note: New custom forms should be authored in the modern form builder. The v1 view is preserved only for legacy form definitions that organizations have chosen not to migrate.

View the form log for a Guest Form

When a guest form is filled out across multiple visits, providers and reviewers sometimes need to see the history of edits to that one guest form definition.

  1. Open the guest profile and select the Consent Forms (or equivalent) tab.
  2. Locate the guest form you want to review.
  3. Select View Form Log to open the change-history panel for that form.
  4. The log lists each edit with timestamp, the user who made the change, the field that changed, and the before/after values.

Tip: Use the form log to audit who last modified a clinical observation or a consent acknowledgement, and when. The log is read-only.

Submit an online membership form in the Customer Mobile App

Guests with a Zenoti account can complete and submit membership forms from the Customer Mobile App, removing the need for in-person form fill at the clinic.

  1. The guest opens the Customer Mobile App and goes to their memberships.
  2. If a membership requires a form (signup, renewal, freeze, cancellation, transfer, or upgrade/downgrade), the system surfaces the bound membership form to the guest.
  3. The guest fills the form, applies signature where required, and selects Submit.
  4. The submitted form is attached to the membership record and flows into the same review and reporting pipeline as forms submitted by staff.

Note: Whether a membership lifecycle event requires a form is governed by the Form action type property on the membership form definition (Signup, Cancellation, Freeze, Upgrade/Downgrade, Transfer, or Renewal). Configure this when the form is created. See Create and manage custom forms.

Upload a custom digital form

For workflows where a guest hands over a completed paper form (for example, a printed intake form, an external lab result, or a signed consent that was filled offline), Zenoti lets a staff member upload the document and attach it to the appointment or guest profile as a custom digital form.

  1. Open the appointment or guest profile.
  2. Navigate to the Forms tab and select Upload digital form.
  3. Choose the file from the workstation. Supported file types and maximum size are configured by your organization.
  4. Select the form definition the upload corresponds to so the document is filed against the right record.
  5. Confirm. The upload appears alongside other forms with an Uploaded indicator on its tab.

This flow does not pre-populate macros or run review randomization β€” the document is treated as a static attachment for record-keeping.

Capture identity from an Emirates ID card

Clinics in the United Arab Emirates can scan a guest's Emirates ID card during form filling to auto-populate identity fields (first name, last name, date of birth, nationality, Emirates ID number) from the card. The integration uses a local card reader attached to the workstation. For setup and configuration, see Configure Emirates ID card reader integration.

AI-powered form filling

When AI-powered form filling is enabled for your organization and your account has the required access, the AI assistant can pre-fill form fields based on the session context.

  1. Open the form for the appointment.
  2. If AI form filling is available, click the AI fill option.
  3. The AI assistant analyzes the session context and populates applicable form fields.
  4. Review the AI-generated entries and make corrections as needed.
  5. Submit the form after verifying the data.

Important: Always review AI-generated form data before submitting. The AI assistant provides suggestions based on context, but you are responsible for the accuracy of the submitted data.

Important: The AI form filling option can be used only once per form per appointment. Once used, the option is no longer available for that form within the same appointment.

Guest medical record integration

When guest medical record (EMR (Electronic Medical Record)) access is enabled, you can view EMR data alongside the form during the appointment.

  1. Open the form view for the appointment.
  2. Access the EMR tab or section to view the guest's medical record data.
  3. Use the EMR data as reference while filling the form.

EMR integration provides clinical context without requiring you to navigate away from the form view.

Submitted form associated with the wrong guest

If a form was submitted under the wrong guest's appointment, you cannot move the submitted form to a different guest's profile β€” Zenoti does not provide a transfer action for submitted forms. Similarly, there is no single-form delete action in the appointment or guest profile view that lets you remove one submitted form record in isolation.

What to do when a form has been submitted under the wrong guest:

The most important step is to ensure the clinical record exists where it is needed. You do not need to wait for the incorrect copy to be addressed before taking this action.

  1. Open the correct guest's appointment.
  2. Fill and submit the form there so the clinical record is attached to the right guest.

Once the correct guest's record is complete, raise the incorrect copy with your administrator. Nothing in the appointment or guest profile view removes it.

Important: A submitted form cannot be moved to another guest's profile, and a single submitted form cannot be deleted from the appointment or from the guest profile through the UI.

Note: If you encounter this scenario from the guest profile's Forms tab rather than from the appointment view, the corrective action is the same: open the correct guest's appointment and submit the form there. See the steps above.

You can print or save a submitted form as a PDF from the form view.

  1. Open the submitted form for the appointment.
  2. Use your browser's print function to open the print dialog.
  3. In the print dialog, adjust paper size, orientation, and scale as needed before printing.
  4. Print the form or save it as a PDF.

Note: If the printed or saved form appears cut off, adjust the paper size, orientation, and scale settings in your browser's print dialog before printing again. The same paper settings that apply to receipts and invoices also apply to forms. This adjustment applies regardless of which browser you use.

Tips

Tip: Use dot phrases for commonly repeated text such as standard observations, treatment notes, or follow-up instructions. This saves time and ensures consistency across providers.

Tip: If you need to add a form that is not associated with the service, ask your administrator about dynamic forms (Forms on the Fly), which allow adding forms to appointments at appointment time.

Tip: If there is any question about whether a form was previously submitted, check the form activity log. The log retains all historical entries β€” including Submitted entries β€” even when the current form fill status has moved backward to Saved after a draft save.

Tip: When selecting a service form entry from the appointment action menu, read the label carefully before selecting. Two entries begin with "Send" and appear adjacent to each other. Select Enter {term} or Show {term} to open the form locally; select Send {term} Link only when you want to email a form link to the guest.

Tip: If a form was submitted under the wrong guest, open the correct guest's appointment and submit the form there first. The correct clinical record can be created independently β€” you do not need to wait for the incorrect copy to be resolved before proceeding.

Troubleshooting

The form fill status shows Saved after I previously submitted the form. A user re-opened the submitted form and saved it as a draft. Under the No restriction (default) editing mode, this transition happens without a warning. Check the form activity log to confirm whether the form was submitted at an earlier point. If the form needs to be finalized again, re-submit it. If a review was previously completed, the review state was also cleared and must be completed again after re-submission.

A reviewed form no longer shows as reviewed. If a form's review state has been cleared, it is because the form was saved as a draft after it was both submitted and reviewed. Saving as a draft clears both the submitted state and the review state simultaneously. The form must be re-submitted and must go through the review workflow again before it can be marked as reviewed. See Manage form reviews.

I cannot re-open or edit a submitted form. The form is locked under a restriction mode other than No restriction (default). A user with the Unlock Forms permission must unlock the form before you can edit it. See Manage form reviews for the unlock procedure. Once unlocked, saving the form as a draft will move it from Submitted back to Saved, and any prior review state will be cleared.

The guest did not receive the service form link I sent from the appointment action menu. Verify that the guest has an email address on file. If no email address is recorded, Zenoti displays an alert instead of sending the message and the link is not queued. Add the guest's email address to their profile and resend the link.

A form was submitted under the wrong guest's appointment. You cannot move a submitted form to a different guest's profile, and you cannot delete a single submitted form through the UI. The immediate action is to open the correct guest's appointment and submit the form there β€” this creates the clinical record where it is needed and does not depend on resolving the incorrect copy first. Contact your administrator to address the record on the incorrect guest's profile.

Was this article helpful?
Your feedback helps us improve our documentation.