Forms FAQ
Answers to common questions about custom forms in Zenoti, covering form types, creation, custom fields, associations, filling, review, compliance, guest access, and permissions.
General
- What are custom forms in Zenoti?
- What form types are available?
- What is the difference between V1, V2, and V3 forms?
- How many forms can I have?
Form creation
Custom fields and lists
Form associations
- How do I associate a form with a service?
- What are visit modes?
- Can I associate a form with all services at once?
Filling forms
- What are dot phrases and how do I use them?
- How does auto-save work?
- Can AI fill forms automatically?
Review and compliance
iPad and mobile
Guest forms
Permissions
Troubleshooting
- A form is not appearing in the appointment
- A submitted form cannot be edited
- Macros are not populating in the form
- Dot phrases are not showing suggestions
- Form compliance statistics are not updating
- Exported.zenform file cannot be imported
General
What are custom forms in Zenoti?
Custom forms let you collect structured data from guests and providers beyond the standard Zenoti fields. You can build forms with various field types, associate them with services, memberships, packages, and guest profiles, and track completion through reports and compliance rules. Forms support the full lifecycle from creation through filling and review.
For a detailed overview, see Forms overview.
What form types are available?
Zenoti supports nine form types:
- Service β Captures data during appointments. Supports review, expiry, and macros.
- Tag β Additional forms attached to services through tags. Supports review and expiry.
- Guest β Collects profile-level data. Available on Webstore. Limited to one per organization.
- Membership β Captures data during membership enrollment and lifecycle actions. Available on Webstore.
- Package β Captures data during package purchases. Available on Webstore.
- Entity β Collects data for custom entities such as equipment. Limited to one per organization.
- Loyalty β Captures data during loyalty enrollment. Available on Webstore. Limited to one per organization.
- Class β Works like service forms but for class bookings. Supports expiry.
- Employee Survey β Collects employee feedback. Only available in V3 format.
What is the difference between V1, V2, and V3 forms?
V1, V2, and V3 refer to the form builder technology, not the form content versioning:
| Version | Builder type | Description |
|---|---|---|
| V1 (KVP) | Key-value pair | The original form format with simple field definitions. Limited field types and layout options. |
| V2 (HTML) | HTML builder | An HTML-based form builder with richer layout capabilities. |
| V3 (JSON) | JSON builder | The modern form builder with the most flexibility, supporting advanced field types, conditional logic, and import/export. Recommended for all new forms. |
Not all form types support all versions. Employee Survey forms are only available in V3. Tag and Membership forms are not available in V1. Check the form type matrix in the Forms overview for full compatibility details.
How many forms can I have?
There is no fixed limit on the total number of forms per organization for most form types. You can create as many Service, Tag, Membership, Package, Class, and Employee Survey forms as you need.
Three form types are limited to one form per organization: Guest, Entity, and Loyalty. If a form of one of these types already exists, Zenoti prevents you from creating a second one and directs you to the existing form.
Form creation
How do I create a form from a template?
When creating a new form, you can select from a template library instead of building from scratch. Templates provide pre-built form layouts for common use cases. Select a template during the form creation process, then customize the fields and layout to match your requirements.
For step-by-step instructions, see Create and manage custom forms.
Can I import or export forms?
Yes. V3 forms support import and export as .zenform files. This allows you to transfer form designs between organizations or share standardized forms across your network. You can export a form from one organization and import it into another, preserving the form structure and field definitions.
For details, see Import and export forms.
What is a.zenform file?
A .zenform file is a JSON-format file that contains a complete V3 form definition, including all fields, layout, and configuration. You can use .zenform files to:
- Back up form designs
- Transfer forms between organizations
- Share standardized forms with other Zenoti users
The file preserves the form structure but does not include submitted data or form-service associations.
Custom fields and lists
What custom field types are available?
Zenoti supports the following custom field types. The modern form builder adds rich components on top of the classic types.
Classic field types (available in all form builders):
- Text β Single-line text input
- Number β Numeric input
- Dropdown β Selection from a custom list
- Radio button β Single selection from a custom list
- Checkbox β Boolean yes/no selection
- Date β Date picker
- Date and time β Date and time picker
- Long text β Multi-line text input
- File upload β File attachment (when file uploads are enabled in your settings)
- Label β Display-only text for instructions or section headers
Modern builder additions:
- Signature β Captures a digital signature via touch or mouse input
- Annotation pad β Drawing canvas for markups and overlays on uploaded images
- Table β Structured tabular data entry grid for collecting repeated sets of related data
- Bulk file upload β Uploads multiple files in a single step
- Content β Displays static HTML (instructions, disclaimers, business logos)
- Columns / Tabs / Panel β Layout tools for multi-column, tabbed, and collapsible sections
For a complete reference, see Form builder components.
Each field supports optional properties such as required validation, regex pattern matching, default values, and print-on-receipt settings.
For setup instructions, see Create custom fields and lists.
Can I use the same custom list across multiple fields?
Yes. Custom lists are reusable across your organization. You create a list once and bind it to any number of dropdown or radio button fields across different forms. If you update the list values, all fields that reference that list reflect the changes.
Lists can contain manual entries (comma-separated values) or bind to existing Zenoti data such as products, services, rooms, vendors, or employees.
Form associations
How do I associate a form with a service?
Open the form from the custom forms list and select the SERVICES tab. Select the services you want to associate with the form, configure the visit mode and notification settings, and save. You can also associate tag forms with services by specifying a tag and tag order.
For step-by-step instructions, see Assign forms to services.
What are visit modes?
Visit modes control when a form is presented to the guest based on their visit history with a specific service:
- First visit only β The form appears only the first time a guest books this service.
- Subsequent visit only β The form appears only on return visits, not the first time.
- Always (all visits) β The form appears every time the guest books this service.
You configure the visit mode when associating a form with a service. Each form-service association has its own visit mode setting.
Can I associate a form with all services at once?
There is no single button to associate a form with every service simultaneously. You associate forms with services individually or in batches from the form's SERVICES tab. For large-scale associations, you can use the bulk import feature to create form-service associations from a structured file.
For import details, see Import and export forms.
Filling forms
What are dot phrases and how do I use them?
Dot phrases are text shortcuts that speed up form filling. An administrator creates a dot phrase with a short code (for example, bp) and expanded text (for example, "Blood pressure: 120/80 mmHg, within normal range"). During form filling in a V3 form, a provider types a period (.) followed by the code. Zenoti displays matching suggestions, and the provider selects one to insert the expanded text.
Dot phrases can be private (visible only to the creator) or shared (available to all users). They support multi-level configuration at the organization, zone, and center level, with lower levels overriding higher-level defaults.
For setup instructions, see Configure dot phrases.
How does auto-save work?
When the auto-save setting is enabled, Zenoti periodically saves the current state of a form as the user fills it. If the session is interrupted (for example, by a browser crash or network issue), the user can retrieve the cached data when they reopen the form. Auto-saved data is stored securely with encryption.
Auto-save is controlled by the Enable auto-save for forms setting. See Configure form settings (Auto-save section).
Can AI fill forms automatically?
Yes. When AI-powered form filling is enabled and the provider has the required access, AI can analyze contextual data and fill form fields automatically. The provider reviews the AI-filled content and makes any corrections before submitting. AI-assisted fills are tracked in the form audit log.
Review and compliance
How does the review workflow work?
When you enable the Require review option on a form definition, submitted forms enter a review queue instead of being marked as complete. A reviewer (such as a manager or senior provider) opens the submitted form, examines the data, and marks it as reviewed.
The review workflow supports several options:
- Assigned reviewers β When the assignee workflow is enabled, a specific reviewer can be assigned to a form during submission.
- Automatic signatures β When enabled, a signature is automatically appended to forms that are reviewed.
- Bulk review β Reviewers can process multiple forms in a single session instead of reviewing them one at a time. Unlock for re-editing β A reviewer with the appropriate permission can unlock a submitted form so the provider can make corrections.
Only Service and Tag forms support the review workflow.
What is forms compliance?
Forms compliance is a tracking system that measures whether your organization meets form submission targets. You define compliance rules that specify a target submission percentage for each center and employee job role. Zenoti generates daily statistics that show how each provider's actual submission rate compares to the target.
Compliance data appears in the compliance tracking dashboard and helps you identify centers or providers that need attention.
For setup instructions, see Forms compliance.
How does review randomization work?
Review randomization distributes the review workload across eligible employees. Instead of assigning every form to the same reviewer, the system randomly selects forms for review based on your compliance rules. This ensures a representative sample of forms is reviewed and prevents bottlenecks in the review process.
You trigger review randomization with Randomize Reviews on the Compliance Tracking page (Medical hub > Form compliance > Compliance tracking).
iPad and mobile
How do I resend an intake form link from the iPad?
To resend a form link to a guest from the iPad:
- Open the guest's appointment in the appointment book.
- Navigate to the Forms section of the appointment.
- Locate the form that needs to be resent.
- Tap the resend/share icon next to the form name.
The system sends a new link to the guest's email or phone number on file. If the resend option is not visible, ensure the form is in a Pending state (not already submitted). Once a form has been submitted, the resend option is no longer available.
Note: The guest must have a valid email address or phone number on their profile for the resend to succeed.
Guest forms
Can guests fill forms online?
Yes. Guests can fill forms through the Webstore in several ways:
- Guest forms β Guests fill profile-level data forms through the Webstore guest form component.
- Service forms β Guests fill appointment-related forms before their visit.
- Membership, package, and loyalty forms β Guests fill enrollment forms during the purchase process on the Webstore.
You can require guests to sign in before accessing forms by enabling the guest access protection settings for each form type. Form links can also be sent to guests via email or text as part of appointment notifications.
How do forms work on kiosk?
During kiosk check-in, the system identifies all missing forms (both guest and service forms) associated with the guest's appointment. The kiosk displays a form selection screen listing all required forms with their fill status. The guest selects a form, fills it, and submits it. The kiosk then navigates to the next form or completes the check-in process.
Guests can choose to skip forms and fill them later if your settings allow check-in without completed forms.
Permissions
What permissions do I need to create forms?
To create and manage form definitions, custom fields, and custom lists, you need the Add and Edit check boxes under CustomFields in the Administrator section of the security role. To export form and list data, you also need Export under Export_Admin in the same section.
Organization admins have these permissions by default. If you do not have access, ask your administrator to update your security profile.
Can I restrict form access by job role?
Yes. Zenoti supports job-based form permissions that control which employee job roles can view or fill specific forms. When configuring a form, you can assign permissions by job role on the form's PERMISSIONS tab. Each permission specifies a form, a job role, and an action type.
At appointment time, Zenoti checks the assigned provider's job role against the form's permission settings to determine which forms the provider can access.
Troubleshooting
A form is not appearing in the appointment
Check the following:
- Form-service association β Verify the form is associated with the correct service. Open the form, select the SERVICES tab, and confirm the service is listed.
- Visit mode β If the form is set to First visit only, it does not appear for return guests. If set to Subsequent visit only, it does not appear for first-time guests.
- Form status β If the form definition is inactive or in draft state, it does not appear at appointment time. Ensure the form is published and active.
- Job-based permissions β If job-based form permissions are configured, the provider's job role must have access to the form. Check the form's PERMISSIONS tab.
- Subsequent visit forms location β Forms configured for subsequent visits appear under the guest profile's Consent Forms tab, not in the appointment's service section.
A submitted form cannot be edited
The form is likely locked by an editing restriction. Check your organization's editing restriction setting under Configuration > Forms > Essentials > Restrict editing forms:
- Restrict editing after closing invoice β The form locks after the invoice is closed. If the invoice is still open, the form should still be editable.
- Restrict editing after form is submitted β The form locks immediately after submission. A user with the unlock permission must unlock it.
- Restrict editing after form is submitted or service date has passed β The form locks after submission or after the service date, whichever comes first.
- No restriction (default) β Forms remain editable indefinitely.
To edit a locked form, ask a reviewer or administrator with the unlock permission to unlock it from the form view.
Macros are not populating in the form
Verify the following:
- Form type β Macros are resolved based on the form type context. Service form macros require an active appointment. Package macros require a package purchase context. Membership macros require a membership context.
- Macro names β Ensure the macro placeholders in the form template match the exact macro names (for example,
GuestFirstName, notGuest_FirstName). See Use macros in forms for the complete macro reference. - Data availability β If a macro references data that does not exist (for example, a guest without a phone number), the macro resolves to an empty value.
- Custom macros β Custom macros (CustomMacro1 through CustomMacro10) must be configured for the center. Check the custom macro data settings under center configuration.
Dot phrases are not showing suggestions
- Modern builder forms β The inline auto-complete picker for dot phrases is available primarily in forms built with the modern form builder. Legacy (HTML-based) forms display pre-filled dot phrase text but do not provide the in-field picker while typing.
- Text fields only β Dot phrases trigger only in text input and text area fields, not in dropdowns or other field types.
- Period trigger β You must type a period (
.) to trigger the suggestion list. If no suggestions appear, verify that dot phrases have been created and are active. - Scope β Check whether the dot phrase is private (visible only to the creator) or shared. If it is private and belongs to another user, you cannot see it.
Form compliance statistics are not updating
- Refresh manually β On the Compliance Tracking page (Medical hub > Form compliance > Compliance tracking), click Refresh to trigger an immediate calculation. Zenoti emails you when the refresh completes.
- Background job β Daily compliance statistics are generated by a background job. If the job has not run, statistics may be stale. Check the last refreshed date shown next to Refresh.
- Rules exist β Compliance statistics are only generated for center and job role combinations that have active compliance rules. If no rules are defined, no statistics are produced.
Exported.zenform file cannot be imported
- Modern builder only β Import/export as a
.zenformfile is available only for forms built with the modern form builder. Legacy (HTML-based) forms cannot be exported or imported in this format. - File format β Ensure the file has the
.zenformextension and contains valid JSON. Corrupted or manually edited files may fail to import. - Custom lists β If the form references custom lists that do not exist in the target organization, the import may fail or the fields may appear without options. Create the matching custom lists in the target organization before importing.