Custom forms
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
- Key terms
- Create a new custom form
- Form statuses
- Add form fields
- Form builder layout
- Map form fields to lead fields
- Set default lead properties
- Activate and share the form
- Understand the Master form
- View or edit the Master form
- Create forms from templates
- Create a template
- Use a template to create a form
- Edit or delete templates
- Considerations
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
- Navigate to AI Lead Manager > Forms.
- Select Create Form.
- 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.
- 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
In the form builder, select Add Field.
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. 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.
- 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
- Select Field Mappings in the form builder.
- For each form field, select the corresponding lead field from the dropdown.
- 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
- Select Activate Form to change the status from Draft to Active.
- Select Share to generate a public link for the form.
- 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
- Navigate to AI Lead Manager > Forms.
- Locate the Master form section at the top of the page.
- 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
- Navigate to AI Lead Manager > Forms and select Manage templates.
- Enter the template header and description.
- Select the template type:
- Lead generation -- For public-facing lead capture forms.
- Master -- For master form templates.
- Add fields and configure their properties.
- Select Save form.
Use a template to create a form
- Navigate to AI Lead Manager > Forms and select Create form.
- Select Use template and choose a template from the list.
- The template fields are copied into the new form.
- 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.