Unbounce Answers/Integrations/General

Setting Up Field Mapping

Aaron Oman
posted this on July 25, 2011 11:34 AM

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:

*The HubSpot integration supports a specific list of target fields.  See How Do I Set Up My HubSpot Integration for more information.

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.  Just follow the steps below to get up and running.

What you will need:

What it will do:

When lead data is collected through an Unbounce form, Unbounce will send the form field data to the mapped fields in your integration.

Setting up Field Mapping

  1. Log in to Unbounce.
  2. Navigate to the page overview for the page whose integration you want to customize through field mapping.
  3. If you haven't already enabled your integration, enable it by following the instructions for the given service.
  4. Click the integration you want to customize through field mapping.  This will open the integration's dialog box.
  5. In the integration's dialog box, click Configure Field Mapping. This will open the Field Mapping configuration dialog.
  6. In the Field Mapping configuration dialog, choose the fields you want to map from the appropriate drop down menu.
  7. Click Done to update your field mapping settings.

You must click "Done" to correctly set up your Field Mapping.  Even though you can see the mapping and it looks like it's all set up, it's not actually configured until you click "Done" to save it.

That's it, you're all set!

Once your field mapping is configured, your Unbounce form fields will be send to the selected target field in your integration. 


You can only have one Unbounce field map to any given integration field.

For instance: with the given Unbounce and MailChimp fields above, you cannot have Submission Time map to UBDATE and also have Page ID map to UBDATE at the same time.

Related Articles

If you are experiencing difficulties with field mapping, please send us an email at support@unbounce.com.



User photo
Michele Kincaid

Tried to access these related articles, but the links are broken. Have they been posted somewhere else?

Related Articles

April 18, 2012 02:24 PM
User photo
Egbavwe Pela

Same here!

April 19, 2012 07:31 AM
User photo
Ryan Engley

Hello Michele and Leigh - thank you for letting us know!  The two articles you mentioned have been published correctly and the links should work.  If you run into any further difficulties be sure to let us know.

May 08, 2012 02:04 PM
User photo
Troy Muir
Hi guys, great feature! I'm just wondering how I can set a default value for a field that I want to pass through to campaign monitor..... But, do not want displayed on the form? I really appreciate your help here. Thanks!
July 27, 2012 05:05 PM
User photo
Aaron Oman

Hi Troy!

You can create a custom field, see here: http://support.unbounce.com/entries/20516286-field-mapping-custom-f...

Simply don't use parentheses to include the value of a form field.

July 27, 2012 05:08 PM
User photo
Troy Muir
Perfect!! Thanks Aaron, exactly what I was trying to figure out. :)
July 29, 2012 05:03 AM
User photo
Brent Daily

I'm trying to map lead source from Unbounce to Hubspot.  I created a hidden field on my page with the lead source.  When I click on the hubspot integration button, and then click configure field mapping, there is no drop down on the Hubspot column for lead source.  Above it says that you can add one but I don't see that option.

September 08, 2012 12:36 PM
User photo
Ryan Engley

Hi Brent - Unfortunately the HubSpot integration only supports a specific list of target fields.  You can see that list in our HubSpot integration set up article.  Sorry for the confusion on this one.

September 11, 2012 05:19 PM
User photo
LT Marketing

I had the same issue as Brent - trying to send custom fields to our HubSpot API which is needed for our HubSpot to Salesforce integration. Since the functionality exists in Unbounce to add a new target field for other integration types, it seems like this would be a simple (and much needed) improvement to the HubSpot integration. I was eventually able to send the extra data to HubSpot, but I had to modify the landing page with hidden form fields and javascript to grab the HubSpot usertoken. I then had to create a custom web page/webhook to process the data from Unbounce and send it along to HubSpot.

(btw - I was very impressed with the ability to add custom code to the Unbounce landing pages and the wysiwyg editor is exceptionally cool)

December 12, 2012 09:16 AM
User photo
Aaron Oman

Hi Nick,

We're currently investigating custom field mapping support for HubSpot. Conceptually it is simple, but there are many confounding factors which make it more difficult in practice.

Regarding the HubSpot usertoken; we already modify your page to capture the HubSpot usertoken when you complete a hubspot integration.  I'm curious why you added custom javascript as well.  Could you elaborate?

As for how you're getting leads to HubSpot: if I understand correctly, you've created an external page that receives webhook messages from Unbounce, then communicates this across to HubSpot via their API?  If so, well done!  And, unfortunately, that will have to be the way to send custom fields to HubSpot for the time being.

December 12, 2012 03:20 PM
User photo
LT Marketing

Thanks for the reply, Aaron. You're correct - my external page captures the webhook post from Unbounce which includes additional hidden fields that I need, then builds a post to push to HubSpot.

Unless I missed something, I believe Unbounce passes the HubSpot usertoken only when using the HubSpot integration. However, for my custom webhook, I had to use javascript to snag the usertoken from the HubSpot cookie and pass it along to my page via a hidden field. (The HubSpot API requires usertoken and IP address)  There's always a chance I made this harder than it needed to be, but it works!

December 12, 2012 03:30 PM
User photo
Aaron Oman

Ah, you're exactly right.  Sorry about that, Nick!

Very cunning on your behalf.  Well done!  It will be excellent when we can reply here and say "Nick!  It automatically works for you now." :)

December 12, 2012 03:33 PM
User photo
Bettina Horvath

Can you please let me know if this integration updates the record of an existing MailChimp subscriber? In other words if someone who is already in the MailChimp database and now fills in another form via an Unbounce landing page will it update inside MailChimp? I struggle with another integration that doesn't do this. If Unbounce is able to I may just have found my solution. 

March 29, 2014 07:11 AM
User photo
Jason Bragg

Hi, I'm trying to do some field mapping with a webhook on A/B test pages. I am capturing different data on the A and B variants. How does field mapping cope with this?



March 30, 2014 07:59 PM
User photo
Quinn Omori

Hi Bettina - if a subscriber that already exists in our MailChimp database fills out a form on page that has the MailChimp integration set-up, it will update their existing record.

Hi Jason - if you have A/B variants with different fields, the mapping will leave any field that isn't on the other variant blank when someone submits from the first variant. So, if you have three fields mapped (email, name, phone) and your A variant only has email and name, phone will be left blank for any leads that fill out the form on the Variant A page.

March 31, 2014 10:04 AM
User photo
Jason Bragg

Hi, thanks for previous answers. I have setup Unbounce and Mailchimp integration which is working. however i have included some hidden fields with default values. This helps us segment and respond based on which form Variant is completed. The hidden fields value is not coming through into mailchimp and I have noticed that data is not showing on 'view lead' reports either. what could I potentially be doing wrong?


April 01, 2014 04:29 PM
User photo
Johnny Opao

Hey Jason - It should at least show up in your lead reporting if you have hidden fields. I've started a support ticket for you so we can investigate further. I have some questions for you before I dig in. Lookout for me email :)

April 01, 2014 04:45 PM
User photo
Peter Whitfield

I'm also having problems with hidden fields. I'm using the webhook integration and I'm trying to pass a hidden field with default value to the webhook, but it's not included in the post. I've configured the hidden field in the form and set up a mapping for the field so it seems as though it should work. How do we go about getting this fixed?

September 24, 2014 02:50 PM