ZenotiHelp

Create custom fields and lists

ZTZenoti Docs Team Updated September 4, 2026 6 min readGuide

Custom fields let you collect additional information beyond the standard fields in Zenoti. You define guest-level fields for profile data and service-level fields for appointment-specific data. Custom lists provide reusable sets of dropdown or radio button values that you bind to custom fields.

Note: For conceptual background, see Forms overview.


On this page


Before you begin

  • You need administrator access at the organization level.
  • If you plan to create dropdown or radio button fields, create the custom list first so you can bind it to the field.

Permission: Add under CustomFields in the Administrator section of the security role β€” Required to create new custom fields and lists.

Permission: Edit under CustomFields in the Administrator section of the security role β€” Required to modify existing custom fields and lists.

Note: A single CustomFields row gates both custom fields and custom lists. There is no separate Custom Lists permission row β€” when an administrator grants Add or Edit under CustomFields, the user can manage both fields and lists within the same scope. If your organization needs to give one team access to lists but not fields (or vice versa), this is not currently expressible through the security objects.

Field types

The following field types are available for both guest and service custom fields.

Field type Description
Text A single-line text input for short values.
Number A numeric input that accepts only numbers.
Dropdown A selection list populated from a custom list. The guest or provider selects one value.
Radio Button A set of radio buttons populated from a custom list. The guest or provider selects one value.
File Upload Allows the guest or provider to upload a file attachment. Availability depends on your organization's upload settings.
Label A display-only text label used for section headers or instructions within a form. Does not collect data.
Checkbox A true/false toggle the guest or provider checks or unchecks.
Date A date picker for selecting a calendar date.
Date and time A date and time picker for selecting both a calendar date and time of day.
Long text A multi-line text area for longer free-form responses.

Create a guest custom field

Guest custom fields appear on the guest profile and collect information that persists across all appointments for that guest.

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

  2. Click Add Field.

  3. Configure the field properties:

    Field Description
    Field name A descriptive name for the field. This label appears on the form.
    Description A brief description of the field's purpose.
    Field type Select the data type for this field (Text, Number, Dropdown, etc.).
    List binding If the field type is Dropdown or Radio Button, select the custom list that provides the values.
    Required When enabled, the guest or provider must fill in this field before submitting the form.
    Default value An optional pre-populated value for the field.
    Show in grid When enabled, the field appears as a column in guest data grids.
    Allow guest to view When enabled, the guest can see this field on the Webstore or guest-facing forms.
    Allow guest to edit When enabled, the guest can modify this field on the Webstore or guest-facing forms.
    Print on receipt When enabled, the field value prints on the appointment receipt.
    Active Controls whether the field is visible and usable on forms.
    Field order A number that determines the display position of this field relative to other fields.
    Span across columns When enabled, the field spans the full width of the form instead of occupying a single column.
  4. Click Save.

Create a service custom field

Service custom fields collect data that is specific to a particular service appointment. Each field is tied to the service and recorded per appointment.

  1. Navigate to Configuration > Forms > Form creation > Service custom fields.
  2. Click Add Field.
  3. Configure the same field properties described in the guest custom field section above.
  4. Click Save.

Tip: Service custom fields use the same property set as guest custom fields. The difference is that service field values are stored per appointment, while guest field values are stored per guest profile.

Field groups

Field groups let you organize custom fields into named sections with optional color coding. Groups create visual separation on the form and help guests and providers navigate large forms.

Each group has the following properties:

Property Description
Group name A descriptive name that appears as the section header on the form.
Group order A number that determines the position of this group relative to other groups.
Color An optional color for the group header to provide visual distinction.

To assign a field to a group, set the field's group property when creating or editing the field.

Field validation

Custom fields support several validation options to ensure data quality.

Validation Description
Required The field must have a value before the form can be submitted.
Regex validation A regular expression pattern that the field value must match. Use this for format enforcement such as phone numbers, postal codes, or custom patterns.
Format function A predefined formatting rule applied to the field value (for example, formatting a phone number or capitalizing text).
Invalid character filtering The system automatically filters out characters that are not allowed in the field based on the field type.

Create a custom list

Custom lists define the set of values available in dropdown and radio button fields. Create a list before you create a field that uses it.

  1. Navigate to Configuration > Forms > Form creation > Custom list.

  2. Click Create.

  3. Enter the list details:

    Field Description
    List name A descriptive name for the list.
    Description A brief description of the list's purpose.
    List type Select the source of the list values (see List types).
    List values If the list type is CSV, enter the values separated by commas.
  4. Click Save.

Edit or delete a custom list

  1. Navigate to Configuration > Forms > Form creation > Custom list.
  2. Click the list name to open it.
  3. Modify the name, description, or values as needed.
  4. Click Save, or click Delete to remove the list.

Note: Custom lists of type Products, Services, Rooms, Vendors, and Employees are populated from the corresponding catalog (product catalog, service catalog, room directory, vendor directory, employee directory). The values shown in those lists are read-only here β€” you cannot add, rename, or remove individual values through the custom-list editor. Manage values in the source catalog instead. Only CSV lists let you edit the value set on this page.

Important: Deleting a custom list marks the list inactive. Existing custom fields that were bound to the list keep their binding, but the list no longer appears as an option when you create new fields, and end users see no values in fields that still point at the deleted list. Before you delete, manually unbind the list from any active fields that still need a dropdown source, or re-bind those fields to a different list. Deleted lists cannot be recovered through the admin UI.

List types

Custom lists support different value sources depending on your needs.

List type Description
CSV You manually enter a comma-separated set of values. Use this for fixed option sets such as "Yes, No, N/A" or "Low, Medium, High".
Products The list is populated from your product catalog. The dropdown displays active products.
Services The list is populated from your service catalog. The dropdown displays active services.
Rooms The list is populated from the rooms defined for the selected center.
Vendors The list is populated from the vendor directory.
Employees The list is populated from the employee directory.

View and export field and list listings

Both the guest custom fields page and the service custom fields page display fields in a paginated, searchable grid. The custom lists page similarly displays all lists.

You can export any of these listings to Excel, PDF, or CSV.

  1. Navigate to the relevant management page (guest fields, service fields, or custom lists).
  2. Use the search bar to filter results.
  3. Click the Excel, PDF, or CSV export icon.

Note: The system generates and downloads the file.

Permission: Export under Export_Admin in the Administrator section of the security role β€” Required to export field and list data.

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