OptinMonster Documentation

Documentation, Reference Materials, and Tutorials for OptinMonster



How to Use Field Mapping to Add Extra Fields to Your Campaign Form

How to Use Field Mapping to Add Extra Fields to Your Campaign Form

OptinMonster makes it easy to create a fully customized campaign form. You can easily add radio buttons, phone fields, text areas, number fields, lists, and more using our Field Mapping feature!

In this article, you’ll learn how to use Field Mapping to add extra fields to your OptinMonster campaign form.

Supported Integrations

Field mapping is a brand-new feature available for our most popular Email Service Providers, including:

Add Fields

To start building a custom optin form you’ll want to add fields to your design.

To customize your optin form using OptinMonster, follow these steps:

  1. Before you start, the Email Address field is always required when using a native integration with OptinMonster. See our FAQs for details on how to add a form to your campaign that does not contain an email address field.
  2. Navigate to the Design screen of the campaign builder to begin customizing your campaign.
    Navigate to the Design view of the campaign builder.
  3. Be sure you are editing the campaign view containing your optin form.
    Edit the specific campaign view which contains your Fields block.
    *In most instances this will be the Optin view, however, you may have moved the Fields block to another view.
  4. Click anywhere within the Fields block in the design pane of the builder, options for editing your optin form’s fields will appear in the left sidebar panel.
    Select the Fields block in your campaign to begin editing it.
  5. To add extra fields, select the Add New Fields button and a modal will appear where you can select any specific type of field you wish to add to your optin form.
    Add extra fields to your OptinMonster optin form.
    You can select from the following field types:
    1. Name – does not require Field Mapping, works with all integrations
    2. Email – does not require Field Mapping, required for all integrations
    3. Phone – does not require Field Mapping, works for all integrations. Cannot be repurposed to capture other numerical data, for that you should use a Number field and configure with Field Mapping.
    4. Text
    5. Text Area
    6. Number
    7. Dropdown Select
    8. Radio Button
    9. Checkbox
    10. Privacy Notice – does not require Field Mapping, works for all integrations, displayed in form but no data is passed to Email Service Provider. *For GDPR requirements you should use a Checkbox field and configure with Field Mapping instead.
  6. Once you select a field to add to your optin form you can configure its settings in the left sidebar panel.
    Optin form configuration options in the OptinMonster campaign builder.
  7. When you’re finished, Save your campaign.

Field Options

Global Field Options

When adding fields to your optin form, you’ll find the following options available:

Duplicate Field

You can quickly duplicate any field by selecting the duplicate icon from the left sidebar panel when editing the optin form:

Duplicate an optin form field in OptinMonster.
Make Field Hidden

You can make any field hidden by toggling the eye icon when editing the optin form:

Make a field hidden in OptinMonster.

Once a field is made hidden it will be moved below the Submit button in the design view and a Hidden label shown to indicate the field will not be visible when the campaign is displayed on your site:

Hidden field in OptinMonster optin form.
Delete Field

You can delete any field from your optin form by selecting the Trash icon while editing the optin fields:

Delete an optin field from your OptinMonster campaign.

*The Email field is always required when using our native integrations and cannot be deleted.
See our FAQs for details on how to add a form to your campaign that does not contain an email address field.

Make Field Required

You can make any field required or optional by toggling the Required option when editing the optin form:

Make any field required in OptinMonster.

*The Required setting is enabled by default when adding new fields.
The Email field is always required when using our native integrations and cannot be made optional.
See our FAQs for details on how to add a form to your campaign that does not contain an email address field, or makes the email address field optional.


The Placeholder is text that will be displayed inside the field. This text is typically used to instruct the visitor on what information to enter into the field, and it is not passed as data to your Email Service Provider.

You can customize the Placeholder text while editing the optin field:

Customize the field placeholder text for your form field.
Field Label

The Field Label is text displayed outside of the optin field, if the Display labels? setting is enabled for your optin form. Field Labels are used by screen readers to improve accessibility for your site visitors and is recommended.

Customize the Field Label for your OptinMonster fields.

You can customize the Field Label styling in the Advanced tab > Field Label Styling section:

Field label styling options in OptinMonster.
Field Name

The Field Name is used internally to identify individual fields in your optin form. This is also the name used to identify each field when you configure Field Mapping.

The Field Name should be unique for each field you add to your optin form.

Customize the name for your fields in OptinMonster.
Error Message

You can customize the Error Message for any field you add to your optin form:

Set a custom error message for any field you add to your OptinMonster optin form.
Field ID

If you’re using Custom CSS or Custom Javascript with your OptinMonster campaign you may need to set a Field ID to easily identify a specific optin field. That can be added when editing any optin field:

Set a custom field ID to target with CSS or Javascript in OptinMonster.
Default Value

The Default Value field is available when configuring the following fields:

  • Name
  • Email
  • Phone
  • Text
  • TextArea
  • Number
  • Dropdown

Smart Tags are also supported in the Default Value field. For many optin fields a Smart Tags icon is available to quickly find and enter default Smart Tags:

Set a Default Value for your optin fields.

The Default Value will populate the input field and is passed as data to your integration if the visitor does not edit the field before submission.

Specific Field Options

Some fields contain additional specific configuration options:


Enable phone field validation?

Disabled by default. When enabled, the user will only be able to submit the following characters: 0-9, (), -, +, .

Enable phone field validation in OptinMonster.
Text Area

Text Area Height

Configure the Text Area field’s height, in pixels.

Customize the Text Area field height.

Min / Max Value

Set a minimum or maximum number value for the Number field:

Number min / max value setting in OptinMonster.
Dropdown / Radio Fields

Field Options

You can add, remove, and arrange specific field options for Dropdown and Radio fields:

Radio and Dropdown Field Options.

Default Selection

By default, no option will be pre-selected for your Radio fields. To make an option pre-selected you can toggle the item:

Default radio option in OptinMonster.

Add Integration

Before Field Mapping can be configured, you’ll need to integrate your campaign with the Email Service Provider you use to store, manage, and email leads from. Follow the documentation for your specific Email Service Provider below to connect your campaign.

Field Mapping

Now that your campaign’s optin form has been customized and you’ve connected your Email Service Provider integration, Field Mapping can be customized! Field Mapping ensures your optin fields are sent to the correct custom fields in your Email Service Provider platform.

Before you start, some integrations require you manually add the custom fields before you map your fields to them. Be sure to check the Supported Integrations section above for your specific integration requirements.

To map your optin fields, follow these steps:

  1. Navigate to the Integrations screen in the campaign builder and select the integration you want to configure Field Mapping for.
    Select the integration to begin Field Mapping.
  2. Below the integration details, you’ll find the Field Mapping section which lists all optin fields added to your campaign.
    Field Mapping section shows all optin fields for your OptinMonster campaign.
  3. The unique Field Name you’ve given to each field in your optin form will be displayed in the first column.
    The Field Name you've given each field in your optin form will be displayed in the first column.
  4. In the second column, select the custom field you want to map the optin field to in your Email Service Provider platform.
    *The Name, Email, and Phone fields cannot be manually mapped to custom fields.
    **Not all integrations allow us to pre-fill this field with existing custom fields. For best results, we recommend you confirm the custom field you want to map to has already been created in your Email Service Provider account, and type the Field ID into the option.
    Select the custom field to map your optin field to in the integration.
  5. Optional: You can also control individually mapped fields’ Visibility and Required settings.
    Configure optional settings for mapped fields in OptinMonster.
  6. When you’re finished, Save the campaign.
  7. Recommended: Before you Publish the campaign we recommend you test the optin form to ensure the data is captured in your Email Service Provider as you expect. Get started Testing your campaign using the Live Site Inspector tool.


How can I prevent spam submissions?

We automatically add a hidden honeypot field to our optin forms to prevent spam, and recommend you configure Google reCAPTCHA for an added layer of protection.

You can also use our Lead Verification feature to further filter and prevent spam submissions.

How can I add a form to my campaign that does not contain the Email Address field?

The email address field is always required when using one of our Email Service Provider integrations.

To create an optin form that does not capture an email address you’ll need to:

  1. Create a form directly from your ESP’s form builder (if they support this).
  2. Add your custom form’s embed code using our Form Embed block, following this guide.


I’m using MailPoet, how can I map my fields?

The process for mapping fields to MailPoet WordPress plugin are different from our other integrations. Please see our MailPoet guide for instructions on mapping fields.

I’m having issues with mapping a field.

The most common problem associated with field mapping configuration is attempting to map a custom field in your campaign to a default field in your Email Service Provider. For example, using a Text field in OptinMonster to capture the First Name and pass it to the default First Name field in your ESP.

It is not possible to map a custom field in OptinMonster to a default field in your ESP. Custom fields in your campaign can only be mapped to custom fields in your ESP.

To send data to a default field you should use the appropriate pre-made field in OptinMonster, for example use the Name Field to send data to the default Name field(s) in your ESP. Or use the Phone field to send phone data to the default Phone field in your ESP.

If you are still encountering issues and the above details do not directly address the configuration you are attempting, please reach out to our support team. We are delighted to help!

My campaign doesn’t contain an optin form, how do I add one?

If your campaign doesn’t yet contain an optin form you can add it to your design by dragging the Fields block into the campaign where you want it to appear:

Add a Fields block to your OptinMonster campaign to create an optin form.

If the Fields block is not available it indicates that your current campaign view already contains a Fields block. It is only possible to add one Fields block to any single design view.

A locked Fields block indicates the campaign already contains a Field block in one of the design views.

Still stuck?

How can we help?

Last updated on

Start Getting More
Leads & Sales Today
with OptinMonster!

Create and launch smart capture forms today in minutes. What are you waiting for?

Create and launch smart capture forms
today in minutes. What are you waiting for?

OptinMonster has transformed our business. Before integrating their optins, our clients saw a 2% conversion rate from web traffic, which is slightly above the standard for their industry. With the integration of OptinMonster’s lightbox popup, exit-intent technology, split testing, and other tools, our client’s conversion rates soared by an unprecedented 500%. They attracted substantially more customers while spending less on digital advertising. Their success propelled them to the top of their markets, outperforming national chains and other medical spas with much bigger marketing budgets. Our client’s success in their market has distinguished us in our own. We are now one of the most sought-after marketing firms in the industry of aesthetic medicine. We know that the integration of OptinMonster, more than any other tool or marketing strategy, has supported this growth and achievement.

chris zelig medstar media

Chris Zelig

Partner, Medstar Media

OptinMonster has been a game-changer for us. From driving donations to collecting new leads, there is nothing that this simple tool has failed to accomplish. Our lead collection rate has jumped by over 1,000%.

joe lowe american bird conservancy

Joe Lowe

Director of Digital Communications, American Bird Conservancy

Through OptinMonster’s exit-intent popups, we have more than doubled our sales conversion rate. Best of all is the compound effect of using OptinMonster over a long period of time—more conversions mean more customers, which means more word of mouth.

mitch smith, managing director, shockbyte

Mitch Smith

Managing Director, Shockbyte.com