ZenotiHelp

AI Auto-Fill for Forms β€” Mobile Animated Fill Sequence

ZTZenoti Docs Team Updated October 26, 2026 9 min readGuide

When you use the AI auto-fill feature in the Zenoti Mobile App (ZMA), the system fills form fields one at a time with a visible animated sequence so you can follow each field as it is populated. This article explains how the aiFillEnabled flag controls whether the animated fill sequence is available, and how to monitor, pause, resume, and cancel the fill sequence, and how to review or revert individual field values after the sequence completes.

Audience: Providers and front desk staff who fill service forms on the Zenoti Mobile App (ZMA) during appointments.


On this page


Before you begin

  • You must be filling a form during an active appointment in the Zenoti Mobile App (ZMA).

  • AI auto-fill can be used once per form per appointment. If the sequence has already run for a form, the option to run it again is not available for that form in the same appointment.

  • The mobile form renderer must have AI fill enabled for the form you are working with. When AI fill is disabled on the form renderer, the animated fill sequence, pulsing sparkle icons, value toggle links, and fill overlay are not shown β€” regardless of any organization-level AI Scribe settings. Contact your administrator if the AI auto-fill option is not visible on a form you expect to use it with.

  • The following permissions are required:

    Permission: View under GuestCustomData β€” required to view guest custom form data. Admin path: Security Roles > [your role] > Guests > GuestCustomData > View

    Permission: View under ServiceCustomData β€” required to view service custom form data. Admin path: Security Roles > [your role] > Services > ServiceCustomData > View

    Permission: View under Export_Admin β€” required to export forms lists to Excel, PDF, or CSV. Admin path: Security Roles > [your role] > Reports > Export_Admin > View

  • The form must be open in the ZMA during an active appointment session.


How the animated fill sequence works

When AI auto-fill runs, the system applies extracted field values to the form's fields in sequence. Text values are typed out character by character so you can read each value as it appears. Non-text values β€” such as selections from a custom list, checkboxes, and date or time fields β€” are applied instantly without a character-by-character animation.

To keep the sequence moving at a predictable pace, the system enforces a maximum typing duration of 900 milliseconds per field. This means that even for long text values, each field completes within that time window regardless of how many characters the value contains.

While the sequence runs:

  • The field currently being filled is highlighted with a teal-tinted animated border and background. When the sequence moves on to the next field, that field's appearance reverts to normal.
  • If the field being filled is inside an inactive tab or a collapsed panel, the system automatically switches to that tab or expands that panel before scrolling to and filling the field. You do not need to navigate manually.
  • A full-screen interaction barrier is active. If you tap the screen during the fill sequence, a toast message reading AI filling is in progress appears and your tap is blocked. This prevents accidental changes while the sequence runs.
  • A pulsing sparkle icon appears on each field as its AI-supplied value is applied.

After the sequence completes, the sparkle icon persists on every field whose value was supplied by AI fill, so you can identify at a glance which fields were touched.

If a field already had a value before AI fill ran, a toggle link appears beneath that field after the sequence passes it. The toggle lets you switch between the AI-supplied value and the original value using a popover preview. See Review and revert individual field values after fill for details.

Note: When AI fill is disabled on the form renderer, none of the adornments described above β€” pulsing sparkle icons, value toggle links, or the fill overlay β€” are rendered. The AI fill sequence does not run in that state, even if AI Scribe is configured at the organization level.


Steps

Start the AI auto-fill sequence

  1. Open the appointment in the Zenoti Mobile App (ZMA).
  2. Navigate to the form you want to fill.
  3. Select the option to fill the form using AI.
  4. The animated fill sequence begins immediately. The interaction barrier activates and the first field is highlighted with a teal-tinted animated border.

Note: AI auto-fill can be used once per form per appointment. If the sequence has already run for this form in the current appointment, the fill option is not available.


Monitor the fill sequence in progress

As the sequence runs, observe the following on screen:

  • The currently active field is highlighted with a teal-tinted animated border and background.
  • Text values appear character by character within the highlighted field, completing within 900 milliseconds per field.
  • Non-text values (custom list selections, checkboxes, dates, times) appear instantly.
  • If the next field is on a different tab or inside a collapsed panel, the system switches the tab or expands the panel automatically before filling that field.
  • A pulsing sparkle icon marks each field as its value is applied.
  • If you tap the screen, a toast appears: AI filling is in progress. Your tap is blocked and the sequence continues uninterrupted.

Pause and resume the fill sequence

  1. While the sequence is running, tap the Pause control displayed on screen.
  2. The sequence stops at the field currently being filled. The teal highlight remains on that field.
  3. When you are ready to continue, tap Resume.
  4. The sequence picks up from where it paused and continues through the remaining fields.

Note: Pausing does not discard any values already applied. Fields filled before the pause retain their AI-supplied values.


Cancel the fill sequence

  1. While the sequence is running or paused, tap Cancel.
  2. The sequence stops immediately.
  3. All field values that were applied before you cancelled remain in the form. Fields the sequence had not yet reached are left unchanged β€” no values are removed or reset for those fields.

Important: Cancelling does not undo values already applied by the sequence. If you want to revert a specific field that was filled before you cancelled, use the Previous Value toggle link beneath that field (if one appears). See Review and revert individual field values after fill.


Review and revert individual field values after fill

After the sequence has run β€” whether it completed normally or was cancelled β€” you can review and revert any field whose original value was replaced by AI fill.

  1. Look for the toggle link that appears beneath any field that had a value before AI fill ran.
  2. The toggle link shows either Previous Value or Use AI Value depending on which value is currently active in the field.
  3. Tap the toggle link to open a popover preview showing the alternative value.
  4. Confirm your selection in the popover to switch between the AI-supplied value and the original value.
  5. Repeat for any other fields you want to review.

Tip: Fields supplied entirely by AI fill (where no prior value existed) display only the pulsing sparkle icon and do not show a toggle link. The toggle link appears only where AI fill replaced a pre-existing value.


Worked example: A provider opens a post-treatment service form for a guest. The form has three text fields: Treatment notes, Follow-up instructions, and Skin condition observed. The guest previously had Treatment notes filled with "Initial cleanse only." After AI auto-fill runs:

  • Treatment notes now shows the AI-supplied text (for example, "Deep exfoliation and hydration mask applied"), and a toggle link reading Previous Value appears beneath it.
  • The provider taps Previous Value to open the popover, reviews the original text, and decides to keep the AI value by dismissing the popover without switching.
  • Follow-up instructions and Skin condition observed had no prior values, so they show the AI-supplied values with pulsing sparkle icons but no toggle links.

Tips

  • Tap the screen intentionally after pausing, not during active fill. The interaction barrier blocks all taps during the fill sequence. Pause first, then make manual adjustments, then resume.
  • Use the sparkle icon as a review checklist. After the sequence completes, scroll through the form and verify each field marked with a pulsing sparkle icon before submitting. The sparkle persists until the form is submitted or closed, giving you time to review every AI-supplied value.
  • Cancel early when you spot an error. If you notice the sequence is filling a field incorrectly, cancel immediately. Fields not yet reached are left blank, and you can fill them manually. Use the toggle link on already-filled fields to revert any incorrect values.
  • The sequence navigates tabs and panels for you. You do not need to open collapsed sections or switch tabs manually before starting AI fill. The sequence handles navigation automatically so all fields on the form are reachable regardless of their location.
  • Remember the once-per-form limit. Because AI auto-fill can only be used once per form per appointment, review the completed fields thoroughly before submitting. If you need to re-run AI fill, you must do so in a new appointment.
  • If the AI auto-fill option is missing, check with your administrator. The option is only visible when AI fill is enabled on the form renderer. An administrator can verify whether AI fill has been enabled for the specific form you are working with.

Troubleshooting

The AI auto-fill option is not available on the form.

AI fill can only be used once per form per appointment, and it must be enabled on the form renderer for that form. If the option is unavailable, either the fill sequence has already run for this form in the current appointment, or AI fill has not been enabled on the form renderer. If you have not previously run the sequence for this form, contact your administrator to confirm that AI fill is enabled for this form. Fill any remaining fields manually in the meantime.

Tapping the screen during the sequence has no effect.

This is expected behavior. The full-screen interaction barrier is active while the fill sequence runs to prevent accidental changes. A toast reading AI filling is in progress confirms the barrier is active. Tap Pause to stop the sequence before making manual changes.

A field was filled with an incorrect value and the sequence has already completed.

If the field had a prior value, tap the Previous Value toggle link beneath it to revert to the original. If the field had no prior value, tap the field directly and edit the text manually. The AI-supplied value is not locked β€” you can edit any field after the sequence completes.

The sequence stopped on a field inside a collapsed panel and did not continue.

The sequence automatically expands collapsed panels before filling fields inside them. If the sequence appears stuck, try tapping Pause and then Resume to prompt the sequence to continue. If the problem persists, cancel the sequence, manually expand the panel, and fill the affected field manually.

A toggle link does not appear under a field I expected it to.

Toggle links appear only on fields that had a value before AI fill ran and where AI fill supplied a different value. If the field was empty before the sequence ran, no toggle link is shown β€” only the sparkle icon. If the AI-supplied value matched the original value exactly, no toggle link appears either.

The fill sequence finishes but some fields are still empty.

AI fill only populates fields for which extracted values are available. Fields with no extracted value are skipped and left unchanged. Fill any remaining empty fields manually before submitting the form.


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