Unbounce allows you to map custom fields from your Unbounce form to many of our third-party integrations. You can currently use field mapping with the following integrations:
What is Field Mapping?
Field mapping allows you to send custom Unbounce form fields over to your integration service. For example, you could map the first_name field in Unbounce over to Insightly's first_name field or map a custom field like hair_colour to the target field of your choice.
How can I use Field Mapping with Unbounce?
Configuring Field Mapping is quite simple! To get started, follow the steps below.
What you will need:
- An Unbounce landing page with a form
- A valid integration with either:
What it will do:
When lead data is collected through an Unbounce form, Unbounce will send the field data to the mapped fields in your integration.
Setting up Field Mapping
- Log in to Unbounce.
- Navigate to your Overview page and click on the Integrations tab.
- If you haven't already enabled your integration, enable and authorize it by following the instructions for Integrating your Pages with any given service.
-
Once your integration is enabled, the integration box will be green, and you’ll see a checkmark beside that integration.
-
Click the integration you want to customize through field mapping. This will open the Unbounce Form Field dialog box.
-
In the Unbounce Form Field dialog, choose the fields you want to map from the appropriate drop-down menu. Customize the destination fields with the appropriate drop-down menu option, as shown in this example:
- Click the Save Changes button to update and save your field mapping settings.
That's it, you're all set! Once your field mapping is configured, the form fields' values will be mapped to the selected target field in your integration.
Field Mapping Custom Fields
Want to combine multiple form fields into a single value? Now you can!
- Follow the instructions above to navigate your way to the field mapping configuration page.
-
Click the + Add Another Custom Field button.
-
This will add a new field map row:
You can enter any text here, and that text will be sent exactly "as is" to the selected integration field. One usage of this feature is the ability to specify a unique page identifier (to supplement the Page ID) to differentiate between leads from different pages.
That's fine and dandy, but the real power of custom fields comes from the ability to combine form fields together.
Including Values into Form Fields
You can include the value of a form field inside your custom field by specifying a form field name in parentheses:
Assuming you have a form field with the name "First Name", then this value will be substituted directly during a form submission.
For instance, if you have the following form submission:
And the following custom field:
When the above form submission is handled by Unbounce, "Aaron is super cool" (without the quotes) will be sent in place of the custom field you just specified.
Combining Form Fields
Since custom fields are simply text strings, you can include as many form fields as you like:
As long as the name in parentheses matches exactly with a form field, then the form field value will be substituted into the custom field during a form submission.
This is essentially the same as our WebHook parameter replacement works. With the custom field "(First Name) (Last Name)", the value: "Aaron Oman" would be sent, using the above form submission.
Glossary
Field Mapping: allows you to send a custom Unbounce form field to a different field in your integration.
Configure Field Mapping: opens the Field Mapping configuration dialog, where you can select which form field data will be sent to the mapped fields in your integration.
Limitations: can only have one Unbounce field map to any integration field.