ZenotiHelp

Custom forms

ZTZenoti Docs Team Updated June 26, 2026 6 min readGuide

Create and manage custom lead capture forms to collect prospect information from your website or marketing campaigns. Forms automatically create leads in AI Lead Manager when submitted.


On this page


Before you begin

Permission: Add (on the My Leads or All Leads permissions) -- Required to create and manage lead capture forms.

Key terms

Term Definition
Master form The organization-wide form that defines the complete set of fields available for storing lead information. Only one Master form exists per organization.
Lead capture form A public-facing form that collects prospect information and creates leads in AI Lead Manager.
Field mapping The process of linking form fields to corresponding lead fields so that submitted data populates the correct lead record.
Form status The lifecycle state of a form: Draft, Active, or Inactive.
Template A reusable form structure that can be used as a starting point when creating new forms.

Steps

Create a new custom form

  1. Navigate to AI Lead Manager > Forms.
  2. Select Create Form.
  3. Configure the basic form settings:
  • Title -- Enter a descriptive name for your form (maximum 500 characters).
  • Form Type -- Select Lead Capture to create a form that generates new leads.
  • Hierarchy Level -- Choose Organization, Zone, or Center to control where the form can be used.
  1. Select Save to create the form in Draft status.

Form statuses

Status Description
Draft The form is being designed. It cannot accept submissions. Forms with unmapped required fields cannot be activated.
Active The form is live and accepts submissions through its shareable URL or embed code.
Inactive The form has been deactivated. Existing share URLs and embed codes no longer work.

Add form fields

  1. In the form builder, select Add Field.

  2. Select the field type. The available field types are:

    Field type Description
    Short Answer A single-line text input for brief responses.
    Paragraph A multi-line text area for longer responses.
    Email An email address input with format validation.
    Phone A phone number input with format validation.
    Dropdown A single-selection list of predefined options.
    Multiple Choice Radio buttons for selecting one option from a list.
    Checkbox Checkboxes for selecting one or more options.
    Date A date picker.
    Time A time picker.
    File Upload Allows the prospect to upload a file.
    Linear Scale A numeric scale for rating questions (for example, 1-5 or 1-10).
    Section Header A non-input layout element that adds a heading to visually group fields.
    Checkbox Grid A grid of checkboxes with rows and columns for matrix-style questions.
    Multiple Choice Grid A grid of radio buttons with rows and columns for matrix-style questions.
  3. Configure each field:

  • Label -- Enter the field name that prospects will see (maximum 500 characters).
  • Placeholder Text -- Add optional placeholder text to guide input.
  • Help Text -- Provide additional instructions if needed.
  • Required -- Toggle on to make the field mandatory.
  • Position -- Arrange fields in your preferred order.
  1. Repeat for each field you want to include.

Form builder layout

The form builder has three panels:

Panel Location Purpose
Field panel Left Lists available field types.
Form canvas Center The main editing area where you arrange and preview form fields.
Properties panel Right Displays configuration options for the selected field.

Each field on the canvas shows a mapping status indicator:

  • Connected -- The field is mapped to a lead field.
  • Not connected -- The field is not yet mapped. Unmapped fields prevent the form from being activated.

Map form fields to lead fields

  1. Select Field Mappings in the form builder.
  2. For each form field, select the corresponding lead field from the dropdown.
  3. Select Save Mappings.

Important: All Lead Capture form fields must be mapped to corresponding Master Form fields before the form can be activated. Incompatible field types (for example, a phone field cannot be mapped to an email field) are not allowed.

Set default lead properties

In the Form properties panel, configure the default values applied to every lead created from this form:

Property Description
Lead stage The initial pipeline stage assigned to new leads from this form.
Lead type The lead type classification.
Source The lead source (for example, "Website Form", "Landing Page").
Priority type The priority level assigned to new leads.
Center The center the lead is assigned to.
Assignee The team member assigned to follow up on new leads.

Activate and share the form

  1. Select Activate Form to change the status from Draft to Active.
  2. Select Share to generate a public link for the form.
  3. Copy the generated URL and use it in your marketing campaigns, website, or social media.

For detailed sharing and embedding options, see Share and publish lead capture forms.

Understand the Master form

The Master form defines the complete set of fields available for storing lead information in your organization.

  • One per organization -- Only one Master form can exist. It serves as the internal field schema for all lead data.
  • Fields cannot be deleted -- Once the Master form is saved, existing fields can only be edited, not removed. Plan the Master form structure carefully before saving.
  • Internal only -- The Master form cannot be shared publicly or embedded on websites.
  • Mapping requirement -- All Lead Capture form fields must be mapped to corresponding Master form fields before the form can be activated.

View or edit the Master form

  1. Navigate to AI Lead Manager > Forms.
  2. Locate the Master form section at the top of the page.
  3. Select Edit form to modify fields, or Preview form to review.

Create forms from templates

Templates provide reusable form structures for quick form creation.

Create a template

  1. Navigate to AI Lead Manager > Forms and select Manage templates.
  2. Enter the template header and description.
  3. Select the template type:
  • Lead generation -- For public-facing lead capture forms.
  • Master -- For master form templates.
  1. Add fields and configure their properties.
  2. Select Save form.

Use a template to create a form

  1. Navigate to AI Lead Manager > Forms and select Create form.
  2. Select Use template and choose a template from the list.
  3. The template fields are copied into the new form.
  4. Modify fields, configure mappings, set default lead properties, and publish the form.

Edit or delete templates

  • To edit a template, navigate to Forms templates, select Edit template, update the fields, and save.
  • Changes to a template apply only to future forms created from it. Existing forms are not affected.
  • To delete a template, select it and choose Delete.

Considerations

  • Only one Master form can exist per organization. Plan its field structure carefully -- fields cannot be deleted after saving.
  • Forms in Draft or Inactive status cannot be shared or embedded. Share URLs and embed codes only work while the form is Active; deactivating a form invalidates any URL or embed code already in circulation.
  • A form with unmapped required fields remains in Draft status and cannot be activated.
  • Incompatible field types cannot be mapped (for example, a phone field cannot map to an email field).
  • Each form edit creates a new version. The public URL remains the same but always serves the latest version.
  • Regenerating a share URL invalidates the previous URL. Distribute the new URL to your audience.
  • Form submissions are validated for human verification before lead creation.
  • Setting the hierarchy level to Organization makes the form available across all centers. Zone and Center restrict access accordingly.
Was this article helpful?
Your feedback helps us improve our documentation.