AI Fill Feature Flag β Mobile Form Renderer
When your organization has not enabled AI-assisted form filling, the mobile form renderer must present forms in a way that is visually and functionally identical to the standard experience. This article explains how the AI fill feature flag controls the appearance of the form renderer on mobile, and what front desk staff and providers can expect when the flag is off.
Audience: Providers and front desk staff who fill forms on mobile devices, and administrators who manage form rendering behavior.
On this page
- Before you begin
- How the AI fill feature flag affects the form renderer
- Steps
- Tips
- Troubleshooting
- Related articles
Before you begin
- You must have access to the Zenoti Mobile App (ZMA) to fill forms on mobile.
- The AI fill feature flag is controlled at the organization level. Contact your Zenoti administrator to confirm whether AI-assisted form filling is enabled for your organization.
- This article covers the mobile form renderer behavior only. For form setup and configuration, see Create and manage custom forms.
Note: The AI fill feature flag is an organization-level setting. When it is disabled, no AI fill UI elements appear anywhere in the mobile form renderer β no configuration is needed at the center level.
How the AI fill feature flag affects the form renderer
The mobile form renderer includes a flag that controls whether AI fill elements are shown during form completion. When the flag is set to off, the following UI elements are suppressed:
| Element | Behavior when AI fill is off |
|---|---|
| Pulsing spark icon | Not rendered |
| Previous Value / Use AI Value toggle | Not rendered |
| Animated fill sequence | Not rendered |
When all three elements are suppressed, the form's layout and appearance are identical to the standard form-filling experience. Staff and guests see no visual indication that AI fill is a capability, and the form behaves exactly as it does in organizations that have never had AI fill available.
Important: This flag affects rendering only. It does not change how form data is saved, submitted, or reviewed. All other form behaviors β draft saving, submission, the Form saved as draft and Form submitted successfully status messages, and the Done button β remain unchanged.
Steps
Verify the current AI fill flag state
- Open the Zenoti Mobile App (ZMA) and navigate to an appointment with an associated form.
- Open the form for the appointment.
- Observe the form field area:
- If no pulsing spark icon appears next to any field, the AI fill flag is off.
- If a pulsing spark icon or a Previous Value / Use AI Value toggle appears, the AI fill flag is on.
Tip: You do not need to fill or submit the form to check the flag state. The presence or absence of the spark icon is visible as soon as the form opens.
Fill a form when AI fill is off
When the AI fill flag is off, fill the form using the standard mobile workflow:
- Open the form in the Zenoti Mobile App (ZMA).
- Complete each field manually. No AI fill prompts or animated fill sequences will appear.
- To save your progress without submitting, tap Save or use the Save & Close option to save the form as a draft. The Form saved as draft message confirms the draft was saved.
- When all required fields are complete, tap Done to submit the form. The Form submitted successfully message confirms submission.
Note: If the form has a Require review flag set by your administrator, the form will enter the review workflow after submission regardless of the AI fill flag state.
Worked example: A provider at a wellness center opens a treatment form for a guest's appointment. The AI fill flag is off for this organization. The provider sees only the standard text fields and custom fields β no spark icon, no AI value toggle, no animated fill. The provider enters notes manually, taps Save to save a draft, completes the remaining fields, then taps Done. The Form submitted successfully message appears and the form moves to the assignee's review queue.
Confirm byte-identical rendering to the non-AI experience
When the AI fill flag is off, the form renders in a layout that is identical to the experience on devices and in organizations where AI fill has never been configured. To confirm this:
- Open the same form on two mobile devices β one where the AI fill flag is confirmed off, and one where it has never been configured.
- Compare field layout, spacing, and controls side by side.
- Verify that no additional icons, toggles, or animations appear on either device.
If you observe any visual difference between the two renders, contact your Zenoti administrator to review the organization-level flag setting.
Use the V2 date picker for date-only fields
The mobile form renderer supports two modes for date-only fields. The host renderer sets the active mode, which then applies to all date fields across the entire form β no per-field configuration is required or available.
When the V2 date picker mode is active, date-only fields use a plain popup-menuβstyle date picker with the default Material tap ripple. When the V2 date picker mode is not active (the default), date-only fields use the original tap trigger without the ripple effect.
The mode is set by the host renderer and propagates automatically to all date fields in the form.
The following table summarizes the two modes:
| Mode | Date picker style | Tap ripple |
|---|---|---|
| V2 date picker (active) | Plain popup menu | Default Material tap ripple |
| Original (default) | Original tap trigger | Ripple suppressed |
Note: Because the mode is set by the host renderer and applies to all date fields uniformly, you cannot configure individual date fields to use different picker modes within the same form.
Tips
- The AI fill flag does not affect form data. All form submissions, drafts, and audit records are stored identically whether the flag is on or off. Switching the flag on or off does not alter previously submitted form data.
- Staff do not need to take any action when the flag is off. The flag is evaluated automatically by the form renderer each time a form is opened. There is no per-form or per-session setting staff need to check.
- If you expect AI fill to be available but do not see the spark icon, check the flag state first before reporting a rendering issue. The absence of AI fill UI elements is the intended behavior when the flag is off, not a defect.
- Form behavior on submission is unchanged. The Form saved as draft, Form submitted successfully, Save, Done, Cancel, and Close controls all behave identically whether the AI fill flag is on or off.
- The flag applies to all form types rendered in the mobile form renderer. Service forms, tag forms, and guest forms all respect the same AI fill flag setting.
- The date picker mode applies to the entire form. If date fields in a form are behaving inconsistently, confirm that the host renderer is running the expected version. The mode cannot be mixed within a single form.
Troubleshooting
AI fill elements appear even though the flag should be off
The flag is evaluated at the time the form opens. If AI fill elements are visible:
- Close the form without submitting.
- Ask your Zenoti administrator to confirm the current flag state at the organization level.
- If the administrator confirms the flag is off, close and reopen the Zenoti Mobile App (ZMA) to clear any cached renderer state.
- Reopen the form. If the AI fill elements persist after a full app restart, escalate to your Zenoti administrator for further investigation.
The form layout looks different from a colleague's device even though AI fill is off on both
Layout differences between devices are usually caused by differences in the form version, not the AI fill flag. Confirm that both devices are displaying the same active version of the form. Only one active version of a form exists at a time; if one device is showing a different layout, one session may be using a cached older version. Close and reopen the app to fetch the current form definition.
"Form saved as draft" does not appear after tapping Save
Draft saving requires the form auto-save setting to be enabled at the organization level. If the status message does not appear:
- Verify with your administrator that the form auto-save setting is enabled for your organization.
- Check your network connectivity β draft save requires an active connection to Zenoti.
- If connectivity is confirmed and the setting is enabled, tap Retry if the option appears, or close and reopen the form to try again.
The form does not open in the mobile renderer
If tapping a form in the Zenoti Mobile App (ZMA) does not open the form renderer:
- Confirm the appointment has an associated form. Forms must be associated with the service before they appear at the appointment level.
- Confirm your job role has the required form access permissions. Form access is controlled by job-based permissions β see Restrict form access by job role for details.
- If the form is associated and permissions are correct, check whether the form has a Draft status. Draft-status forms are not available for filling until published as Active by an administrator.
Date fields show unexpected ripple behavior
If date-only fields display a tap ripple when you expect the original suppressed behavior, or vice versa:
- Confirm with your Zenoti administrator which date picker mode the host renderer is configured to use.
- Close and reopen the Zenoti Mobile App (ZMA) to ensure the renderer has loaded the current configuration.
- Reopen the form and test a date-only field. The mode applies to all date fields in the form simultaneously β if one date field shows the expected behavior, all should.
- If the behavior remains inconsistent after a full app restart, escalate to your Zenoti administrator for review of the host renderer configuration.