Home/HighLevel/Features/Sites/How to add custom fields to a HighLevel chat widget

Funnels, Websites and Forms

How to add custom fields to a HighLevel chat widget

In short

Custom fields let a HighLevel chat widget collect extra information beyond the standard name, phone/email, and message fields. You can create up to five total fields, choose from several data types, set them as required, and control validation before the contact is saved.

AreaSites · Chat Widget
Used forDental practice, Real estate agency, Online coaching business
Setup steps7 steps in 1 task
Last updatedNovember 16, 2026

01Who this is for

  • Founders of SaaS startups, they need extra lead data to qualify prospects directly from chat interactions.
  • Marketing managers at service firms, they can capture appointment preferences or budget details through custom fields.
  • Customer support leads at ecommerce brands, they gather order numbers or product SKUs without leaving the chat.

02Custom Fields, explained

The custom field feature extends the HighLevel chat widget’s contact form. It lives inside the chat widget builder where standard fields such as Name, Phone or Email, and Message are already present. Users can add new fields alongside these defaults.

Each new field can be one of several data types, including single line, multi line, monetary, numeric, phone, date picker, or a single option dropdown. Fields can be marked as required, showing an asterisk, and the form cannot be submitted until required entries are completed. Phone fields validate against country codes, while email fields check proper formatting.

03How businesses use Custom Fields

  • Dental practice. The practice adds a date picker field for patient birthdate and a numeric field for insurance ID. These fields are marked required so the contact form collects necessary details before creating a patient record.
  • Real estate agency. The agency adds a dropdown field listing budget ranges and a single line field for property type. Marking them required lets agents gather qualification data directly from chat visitors.
  • Online coaching business. The coach adds a numeric field for desired session frequency and a multi line field for specific goals. Required validation ensures prospects provide complete information before the coach follows up.

04The numbers and rules that matter

  • Maximum of 5 fields total, including standard and Custom Fields.

05How to set up and use Custom Fields in HighLevel

Add custom fields to a chat widget

  1. Open the builder for the chat widget you want to modify.
  2. Select the option to add a new field to the contact form.
  3. Choose the field’s data type from the supported list.
  4. Enter a label that describes the field’s purpose.
  5. Toggle the setting to make the field required, if needed.
  6. Repeat the process for additional fields while keeping the total under five.
  7. Save the widget configuration to apply the new fields.

06What it looks like in HighLevel

07Settings that matter

  • Supported Custom Field Types. Determines which data formats a new field can accept, such as single line, multi line, monetary, numeric, phone, date picker, or dropdown.
  • Field Limitations. Controls the maximum number of fields, up to five total including standard fields, and enforces that either phone or email is mandatory.

08Things to know before you rely on it

  • A maximum of five fields can exist on a widget, counting both standard and custom entries.
  • Either phone or email must be present; one of them is required for contact creation.
  • If more than one phone field is added, only one country flag can be chosen and changes sync across all phone fields.

09How it connects to the rest of HighLevel

Michael's take

Michael Reimer
Michael ReimerFounder of CRM Pros, HighLevel Commander and Certified Admin

Custom Fields in the chat widget are a nice way to gather extra data without building a separate landing page.

Skip it if you only need name, phone/email and a short message. Adding more fields can slow down the visitor’s experience.

Get More InformationOpens on HighLevelPublished November 2, 2026 · Updated November 16, 2026

Common questions

Common questions about Custom Fields.

Can I add more than five fields to the chat widget?

No. The widget allows a total of up to five fields, which includes both standard and custom entries.

Are the standard fields still mandatory after I add custom ones?

Yes. Name, Phone or Email, and Message remain mandatory, and any custom field you mark required will also be required.

How does phone number validation work for custom phone fields?

Phone fields validate based on the selected country code. If multiple phone fields exist, changing the country flag in one updates the others.

Can I make a custom field required?

Yes. You can mark any custom field as required, which adds an asterisk and prevents form submission until it is filled.

What happens if I add two phone fields?

Both fields share a single country flag. Changing the flag in one field automatically changes it in the other.

Next step

Pick the features that matter. Then get the plan that unlocks them.

Explore the features you want, start with the five at the top, and upgrade through my link when you are ready. The bonuses and the team come with it.

The features directory explains every HighLevel feature in plain English. Browse it to see what the platform can do.

Back to the FeaturesSee the full details
⌃

Site preview

Explore the next page

This destination is reserved in the page inventory and is not built yet.