Lead Capture Form Widgets

The Lead Capture Form (LCF) Widget allows you to present various FORMS in your website that present different offers to consumers e.g. "Get Property Alerts". When the form is filled in and submitted, the contact details are captured as a lead in your account.

You can also create Custom Lead Capture Forms that allow much more customization.

The LCF Widget is a multi-purpose widget that allows the same underlying FORM to be used in different ways. A single LCF widget may be re-used many times, and can be deployed differently each time.

The purpose of the "lead capture forms" is to encourage consumers to SIGN UP for an OFFER that you make on the form (e.g. "Get Alerts", "Get a Relocation Pack" etc).
The lead capture forms will create an inquiry with a task so that YOU can fulfil the offer made!
For example, the type="cma" does NOT generate a "home valuation" report for the lead, it creates a notification and TASK for you to take appropriate action; and the "alerts" type will NOT create a property alert, it simply creates a notification and TASK for you to take action and manually create the alert for this lead.
(The Custom Lead Capture Form method DOES include a method to automatically create alerts).

Available Forms

  • CMA - shows a typical CMA form which helps sellers tell you about their property for sale
    Note: Because the CMA forms use Google Map API to help with address lookup, there can only be one instance of a CMA form on a page - and this cannot be on a page with the Map.
  • CMA Short - CMA form with fewer options
  • Dream Home - shows the 'dream home' form for helping buyers define their needs
  • Contact Me - shows the 'contact me' form for general contact
  • Alerts - allows the consumer to request email property alerts
  • Alerts Short - short form with fewer options, allowing consumer to request email property alerts
  • Showing - consumer may request a showing (general form, not linked to a property)
  • More Info - consumer can request more information on a property (general form, not linked to a property)

Lead Capture Process



Without any filters applied, this widget will show the default Lead Capture Form that lets consumers sign up for email alerts.

Display Options

  1. Embed the widget shortcode on a web page to show the required form.
  2. Alternative Form Display as a Popup / Modal.
    In this case, a button can be used to show the form in a pop-up /modal.
    A default title will always be shown at the top of the form.

    To show the form, you will need to add a class "bfg-show-lcf" to the button.

    For example, the following will show a button that, when clicked, will display the CMA Short form:
<input type='button' class='bfg-show-lcf' filter='form:cmashort+formname:CMA request' value='Show Form'>


Widget ID (required)

This defines the widget to be a lead capture form widget


A Filter string for a LCF widget can include additional parameters that define the form and how it is to be used. The various parameters can be combined as needed by using the PLUS + sign (no spaces) to join the parameters.

The following filters can be used:

  • form (type of form)
  • formname (create a reference for yourself for inquiries)
  • phone_rqd (make phone required or not required)
  • redirect
  • welcome_email
  • campaign
  • campaign_existing
  • mbbagent
  • showtitle
  • title
  • description
  • backgroundpanel
  • labelcolor
  • textcolor

Type of Form

There are 7 possible values. Each form type is designed to collect slightly different information.

  • cma - CMA
  • cmashort - condensed CMA form
  • dh - dream home
  • contactme -contact me
  • alerts - consumer request to receive email alerts
  • alertsshort - condensed email alert request
  • showing - showing request
  • moreinfo - property information request



The formname variable is used in the email correspondence back to the lead and also is the label to the 'Follow Up Task' that is shown in your Leads and Contacts account and alerts sent to you.
This is a simple way for you to distinguish the type of inquiry so that it's easier for you to follow up.

Probably the most important consideration in setting formname is making sure it 'reads' well in the email sent to the Lead.
In the email, it will used on the end of a sentence like this
"We have received your request for {formname}"


filter='formname:a free starbucks card'
  • The email to the lead will then says: We have received your request for A Free Starbucks Card.
  • And, the TASK in the LAC says "Inquiry Received: A Free Starbucks Card Follow Up"

So, some other examples might be

  • formname:contact
    Email to lead will say: We have received your request for Contact.
    Task in LAC says Inquiry Received: Contact Follow Up
  • formname:a relocation pack
    Email to lead will say: We have received your request for A Relocation Pack
    Task in LAC says Inquiry Received: A Relocation Pack Follow Up
  • formname:a home valuation
    Email to lead will say: We have received your request for A Home Valuation
    Task in LAC says Inquiry Received: A Home Valuation Follow Up

Require Phone Number, or Not

There are 2 possible values.

  • phone_rqd:yes. This will make the mobile phone number required
  • phone_rqd:no. This will make mobile phone number not required

If this filter is NOT specified, then the form will use the Lead Capture Settings set in CRM Settings for your account.
So, if the Account's Lead Capture Settings 'require' phone number, but you wish to have a form where this is not required, then specify phone_rqd:no.

Text and Styling Options

The default setting is not to specify this filter at all.
Any value (e.g. 'yes') will show the default titles text on on-page forms (the default titles are always shown on popups if they are used so that the form has a heading).

If this is set, it will always be displayed.

This requires that the title is also set. If this is set, it will always be displayed.

filter="backgroundpanel: {requires 4 comma separated numbers as "rgba" values}"
The only variable is the background panel color as "rgba".
If this is set, then the form will be displayed on a background panel with a max-width of 850px.

E.g. "labelcolor:#5C5C5C"
This will set the color for label and title text.

E.g. "textcolor:#5C5C5C"
This will set the color for the body text on the form.

Redirect after Submission (optional)

By default, when someone fills out a Lead Capture Form they will be shown a "Your submission was successful" message in a popup. The "redirect" parameter allows to change this behavior and redirect your prospects to a new web page.
Make sure you specify a full URL including "http://...".



Send Welcome Email?

By default when a "new lead" fills out a Lead Capture Form they will receive a welcome email. You can choose to suppress this welcome email by including the welcome_email variable.
We suggest you use this in combination with the "campaign" setting below.


Assign a Campaign (optional)

The campaign variable allows you to assign leads to an existing drip email campaign that is setup within your Leads and Contacts account. They will then automatically receive emails from that campaign. You can obtain the "campaign id" from the listing of the campaign details in Leads and Contacts.

There are two cases (both can be specified):

  • For New Leads: filter="campaign:campaignID"
    We suggest you combine this with the "welcome_email" setting above.
  • For Existing Leads: filter="campaign_existing:campaignID"
    For existing leads, if this is not specified, then the standard system auto-responder email will be sent to the lead as a confirmation.



Assign Inquiry to a User (optional)

The Referral ID variable allows you to assign the inquiry to a specific User / Agent in your account. You can obtain the Referral ID from the User Profile page. Note - this is NOT the MLS Agent ID, the Referral ID is a unique id for this user in the MBB system.




<div id='MBBv3_LcForm' filter='...'></div>
[mbb _widget id='MBBv3_LcForm' filter='...']


Using the CMA filter as an example:

<div id='MBBv3_LcForm' filter='form:cma+formname:cma request'></div>
[mbb_widget id='MBBv3_LcForm' filter='form:cma+formname:cma request']


Form Title

This option is no longer supported

Updated on November 4, 2021

Was this article helpful?

Related Articles

Need Support?
Can't find the answer you're looking for?
Contact Support