Setting Up Field Mapping


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 MailChimp's 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:

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

  1. Log in to Unbounce.
  2. Navigate to your Overview page and click on the Integrations tab. 
  3. If you haven't already enabled your integration, enable and authorize it by following the instructions for Integrating your Pages with any given service.
  4. Once your integration is enabled, the integration box will be green, and you’ll see a checkmark beside that integration.
  5. Click the integration you want to customize through field mapping. This will open the Unbounce Form Field dialog box.
  6. 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:
  7. 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.

Adding New Fields to Your Field Mapping

Adding a new field to your field mapping setup lets you map a value from Unbounce to a new field with your integration service.

How can I use the Add New Field Feature?

If you have a value in your Unbounce form that doesn't exist in your integration service, the (+) Add New Field feature will automatically add a new field in your integration service. This is handy because you can manage the integration right within Unbounce without having to hop around from service to service.

This functionality is only available when supported by the third-party integration the form data is being sent to. Unbounce cannot guarantee this functionality for all its integrations.

What you will need:

What it will do:

The (+) Add New Field feature will create a new field in your integration service and send data from your Unbounce form over to that field.

Adding a New Field to Your Field Mapping Setup

  1. Log in to Unbounce
  2. Navigate to your Overview page and scroll to the bottom of the page where you’ll see all of the integrations.
  3. Click the integration you want to customize through field mapping. This will open the Unbounce Form Field dialog box.
  4. In the Field Mapping configuration dialog, open the drop-down menu for the field you want to map over. Select (+) Add New Field:add-a-new-field.png
  5. This will take you to the Add New Field dialog box.
  6. Fill in the requested information in the new dialog box:add-a-new-field-2.png
  7. Click the blue Add Remote Field button to add the new field to the target integration.
  8. This will close the Add New Field dialog box.

That's it, you're all set! Be sure to click the Save Changes button to update and save your field mapping settings.

Once you add the remote field and select it in your field mapping setup, Unbounce will map the select form field over to that target. To double-check this setup, log into your third-party integration and view this newly-created field from the current list of form fields. 

Field Mapping Custom Fields

 Want to combine multiple form fields into a single value? Now you can!

  1. Follow the instructions above to navigate your way to the field mapping configuration page.
  2. Click the + Add Another Custom Field button.add-another-custom-field.png
  3. This will add a new field map row: add-another-custom-field-2.png

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.



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.

Do you agree or disagree with this statement: This article helped me find the information I needed quickly and easily.

Select an option and leave us some feedback in the comments:

Strongly DisagreeDisagreeSomewhat DisagreeUndecidedSomewhat AgreeAgreeStrongly Agree

Measuring Customer Effort Score with Nicereply