ZenotiHelp

Master form (lead details collection)

ZTZenoti Docs Team Updated June 26, 2026 3 min readGuide

The Master form defines the complete set of custom fields available for storing lead information in your organization. It is a special Lead Details Collection form that controls which fields appear in lead records and how external lead capture forms map their data.

Before you begin

Permission: Edit (under All Leads) -- Required to configure the Master form.

  • Your organization must have AI Lead Manager enabled.
  • Only one Master form exists per organization. If your organization does not have one yet, you must create it before activating any lead capture forms.

How the Master form works

The Master form serves two purposes:

  1. Defines custom lead fields -- Any field you add to the Master form becomes available as a custom data field on every lead record. These fields appear in the Additional lead details section of the lead detail page.

  2. Controls field mapping -- Every field on a lead capture form must be mapped to a corresponding Master form field before the capture form can be activated. This ensures that data collected from external sources flows into the correct lead fields.

Create or edit the Master form

  1. Navigate to Lead Management > AI Lead Manager > Forms.

  2. Locate the Master Form (it is marked as a Lead Details Collection form).

  3. If no Master form exists, select Create Form, choose Details Collection as the form type, and save.

  4. Use the drag-and-drop form builder to add fields. The form builder supports 14 field types:

    Field type Description
    Short Answer Single-line text input.
    Paragraph Multi-line text input.
    Email Email address field with validation.
    Phone Phone number field with validation.
    Dropdown A list of predefined options where the user selects one.
    Multiple Choice Radio button options where the user selects one.
    Checkbox One or more checkboxes the user can select.
    Date A date picker.
    Time A time picker.
    File Upload Allows the user to upload a file.
    Linear Scale A numeric scale (for example, 1 to 10).
    Section Header A visual divider for organizing the form (not a data field).
    Checkbox Grid A matrix of checkboxes arranged in rows and columns.
    Multiple Choice Grid A matrix of radio buttons arranged in rows and columns.
  5. For each field, configure the following properties:

  • Label -- The display name of the field (maximum 500 characters).
  • Placeholder text -- Hint text shown inside the field before the user types.
  • Help text -- Additional instructions displayed below the field.
  • Required -- Toggle to make the field mandatory.
  • Field-specific options (for example, dropdown choices, scale range, grid dimensions).
  1. Select Save.

Important rules

  • Only one Master form can exist per organization. A new Master form cannot be created if one already exists. To change the field set, edit the existing Master form rather than recreating it.

  • Fields cannot be deleted after saving. Once you save the Master form, existing fields can only be edited -- they cannot be removed. This protects data integrity for lead records that already reference those fields.

  • The Master form cannot be shared or embedded. Unlike lead capture forms, the Master form is for internal configuration only. It does not support shareable URLs or embed codes.

  • All capture form fields must map to Master form fields. Before you activate a lead capture form, every field on that form must be mapped to a compatible Master form field. Unmapped fields prevent the capture form from transitioning to Active status.

  • Incompatible field types cannot be mapped. For example, a Phone field on a capture form cannot be mapped to an Email field on the Master form. Only compatible field types are available as mapping targets.

Tips

  • Plan your Master form fields carefully before saving, since fields cannot be removed later.
  • Add all the custom data fields your organization needs before creating lead capture forms, so that mapping options are available.
  • Use Section Header fields to organize related fields into logical groups for easier navigation.
  • Review the Master form periodically to ensure it includes all fields needed by new lead capture forms.
Was this article helpful?
Your feedback helps us improve our documentation.