ZenotiHelp

Custom fields & forms

ZTZenoti Docs Team Updated September 23, 2026 4 min readGuide

Configure custom fields for services to capture additional guest information during booking and service delivery, and associate forms with service categories.

Audience: Administrators and managers who manage the service catalog and guest data collection workflows.


On this page


Before you begin

  • Your organization must have custom fields enabled. The Enable Custom Fields org setting must be on before custom field definitions appear in the admin interface.

  • You need the following permissions:

    Permission: Edit (under CustomFields in the Administrator section) — Required to create and modify custom field definitions.

    Permission: Edit (under ServiceCustomData in the Appointment Book section) — Required to edit custom field values for services.

    Permission: View (under ServiceCustomData in the Appointment Book section) — Required to view custom field values without editing them.

    Permission: Edit (under Services in the Administrator section) — Required to associate forms with services.

  • Decide whether to create custom fields for specific services or entire service categories before you begin.

  • If using HTML forms, ensure the forms are already created in your system before associating them with services.

Important: Service custom fields (additional data captured on the service definition) are distinct from service forms (guest-facing intake and consent documents). Do not confuse the two — they are configured separately and serve different purposes.

Steps

Configure custom fields for services

  1. Navigate to Configuration > Forms > Form creation > Service custom fields.

  2. Click Add Custom Field.

  3. Configure the following settings:

    Field Description
    Field name Enter a descriptive name for the custom field.
    Field type Select from text, number, date, or dropdown.
    Required Check this box if the field must be completed before payment or appointment start.
    Validation rules Set any data validation requirements for the field.
  4. Click Save.

  5. Associate the custom field with services:

    • Select Specific services to apply the field to individual services.
    • Select Service category to apply the field to all services in a category.
  6. Choose the services or categories from the available list.

  7. Click Save associations.

Note: Users with the View permission but not the Edit permission under ServiceCustomData can view custom field values but cannot modify them.

Worked example: A medispa creates a custom field named "Skin sensitivity level" (dropdown type, required) and associates it with all services in the "Facial Treatments" category. Front desk staff must select a value before closing the invoice for any facial service.

Associate forms with services

Forms are not selected for a service on this page. A form is attached to a tag, and the tag is then selected on the service's Custom tab under Additional Forms. See Service-level forms.

Associate forms with service categories

  1. From the Custom forms page, click Category associations.
  2. Select a service category from the dropdown.
  3. Choose the forms to associate with all services in this category.
  4. Click Save category association.

Note: Category-level form associations apply to all services within that category. Service-specific associations override category associations.

View custom field change history

  1. Navigate to the service with custom fields.
  2. In the Custom fields section, click View history next to any field.
  3. Review the version history showing:
    • Previous field values
    • Change timestamps
    • User who made each change
  4. Click Close to return to the service details.

Tips

  • Use descriptive field names that clearly indicate what information should be entered. Guests and front desk staff see these labels directly.
  • Use dropdown fields for standardized responses (such as skin type or sensitivity level) to ensure data consistency across your reports.
  • Test form associations by booking a test appointment to verify forms appear correctly during the booking process before rolling out to all centers.
  • Regularly review custom field usage to identify fields that may no longer be needed and remove unused associations to keep the service form clean.
  • If you need to enforce custom field completion before payment, enable the Make it mandatory to enter service custom data fields before payment org setting. A separate setting controls enforcement before appointment start.

Troubleshooting

Custom fields do not appear on the service.

Verify that the Enable Custom Fields org setting is turned on. If the setting is enabled but fields still do not appear, confirm that the custom field definition has been saved and that the field is associated with the correct service or service category.

A user cannot edit custom field values.

The user requires the Edit permission under ServiceCustomData in the Appointment Book section of the security role. Users with only View can see values but cannot change them. Ask your administrator to update the user's security role.

A form associated with a service does not appear during booking.

Confirm that the form is active. If the form should reach the service through a tag, check that the form is assigned to the tag and that the tag is selected in one of the service's Additional Forms slots — see Service-level forms. If the form was associated at the category level, verify the service belongs to that category. Also check whether the form is configured to appear for first visits, subsequent visits, or both — a mismatch in visit configuration is a common cause of forms not appearing as expected.

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