1. Arrow Left Icon Plugins
Mailchimp Plugin Icon

Mailchimp Plugin

Create new Mailchimp subscribers from form results.

Use the Mailchimp Plugin to create and update Mailchimp subscribers from new form results.

Add new subscribers to your subscriber list and optionally slot them into single or multiple groups, complete with options for conditional opt-in or always opt-in.

Setup the Plugin

Go to the Plugins page in your form, select Mailchimp and click the Connect to Mailchimp button to launch the authorization popup:

Connecting to the Mailchimp Plugin

Click Allow to grant the plugin permission within the authorization popup:

Allow permissions in the Mailchimp authorization window

Once Mailchimp is authorized, select the Audience to create new Mailchimp subscribers in, then click Save:

Selecting the Mailchimp Audience to connect to the form

Once setup, you’ll see your chosen Mailchimp Audience name in the plugin configuration.

Create Subscribers with Mailchimp

To create new Mailchimp subscribers from form results, use the Field Mapper within the Mailchimp Plugin to connect form fields to Mailchimp merge tag names.

Subscribe with Email

First create a form and add an Email Field:

An example form we've connected the Mailchimp Plugin to with an email field

Create the connection to the Email Field with a Mailchimp merge tag name email with the Field Mapper:

Using the Field Mapper to connect the email form field to Mailchimp's 'email' merge tag name Field type ‘Email’ • Field Mapped to ’email’

Click Save and Publish, then enter some data in your form and click Send:

Entering an example email in our form's Email Field

A Mailchimp subscriber is then created from the email entered value when the form is submitted:

Viewing the newly created Mailchimp subscriber inside the Mailchimp app

That’s it! To include extra fields, groups, tags and opt-in checkboxes - read on.

Subscribe with Extra Fields

Mailchimp uses “merge tags” to reference different attributes of a subscriber, such as their First Name, Email or Phone.

Access the full list of merge tags available (including custom ones) in the Mailchimp app by clicking Audience in the sidebar and following the next few steps:

Clicking 'Audience' in the Mailchimp app sidebar

Then, click Settings:

Clicking 'Settings' in the 'Audience' page in the Mailchimp app

Finally, click Edit audience fields:

Clicking 'Edit audience fields' in the Mailchimp app to view the merge tags

You’ll then see all merge tags, with the values we need highlighted:

List of all Mailchimp merge tags inside the Mailchimp app

Always use the merge tag name highlighted purple, e.g. FNAME not MERGE1

Here is the full list of Mailchimp merge tag names for you to copy, you can pick and choose which to use for your form:

  • EMAIL - Subscriber email (always required)
  • FNAME - Subscriber first name
  • LNAME - Subscriber last name
  • ADDRESS - Subscriber address location
  • PHONE - Subscriber phone number
  • BIRTHDAY - Subscriber birthday
  • COMPANY - Subscriber company

Let’s add First Name and Company fields to our form and then map them to fname and company:

Adding First Name and Company fields to our example form connected to the Mailchimp plugin

Create the connection to each field with a Mailchimp merge tag with the Field Mapper:

Using the Field Mapper to connect form fields to Mailchimp field tag names

Click Save and Publish, then enter some data in your form and click Send:

Entering example data in our form for First Name, Company and Email

Then view the new subscriber inside Mailchimp with the extra First Name and Company field data:

Viewing the Mailchimp extra field metadata for our new subscriber that includes the Company and First Name of the subscriber

Adding to Group(s)

Automatically add new Mailchimp subscribers to one or more groups, based on the answers supplied in their form result.

Click Audience and expand the Manage audience menu, then select Groups:

Clicking and viewing the 'Groups' page inside Mailchimp

To create a group, click Create group:

Clicking 'Create group' inside the Mailchimp 'Groups' page'

Next, give a name to your Group category, for example Interests (we’ll use this group category name shortly). Then enter each group name, such as Arts, Science and Technology, and click Create group:

Adding group category and group options 'Arts', 'Science' and 'Technology'

Mailchimp group categories “contain” the groups your subscribers will be added to.

Single Groups: To allow the user of your form to be added to a single group you’ll want to use a Single-Select Field or Dropdown Field.

Multiple Groups: To allow the user to select multiple groups at once you’ll want to use the Multi-Select Field.

After adding either a Single-Select, Multi-Select or Dropdown Field to your form, click Edit and in the Options list add each Mailchimp group name:

Adding the new Mailchimp group names in the Fun Forms options field list

Create the connection to Mailchimp that the options are group names, use the Field Mapper and add a group_ value followed by the group category name, interests in our example:

Configuring the Field Mapper to instruct Mailchimp that our Multi-Select Field contains group names via a 'group_interests' value

group_interests is required to instruct the Mailchimp Plugin that this field contains groups. Simply suffix group_ with your group category name, such as group_hobbies for “Hobbies”.

Click Save and Publish, then enter some data in your form and click Send:

Entering an example email and selecting 'Science' and 'Technology' from the Multi-Select Field options in our form

We can then see the Science and Technology groups now contain a new subscriber:

Viewing the Mailchimp subscriber added to both groups 'Science' and 'Technology'

Locating the new subscriber also displays the groups they belong to:

Viewing the new Mailchimp subscriber 'Interests' column displaying their groups of 'Science' and 'Technology'

What’s more is you can repeat the process by adding another field, more groups, and configuring them in the Field Mapper to add subscribers to multiple groups across multiple form fields.

Auto-Add to a Single Group

To automatically add new subscribers to a single group without their input, opt for the Hidden Field:

Adding Fun Forms's Hidden Field to an example form linked to Mailchimp Viewing the form inside the Editor

Once added, click Edit and you’ll see Name and Value. Enter any unique name into the Name field, followed by the group name inside the Value field:

Entering a unique group key and value inside Fun Forms's Hidden Field

Create the connection to Mailchimp that the Hidden Field contains a group name, use the Field Mapper and add a group_ value followed by the group category name, interests in our example:

Configuring the Field Mapper to instruct Mailchimp that our Hidden Field contains a group name via a mapping value of 'group_interests'

Click Save and Publish, and you’ll notice the Hidden Field is not visible to the user. Then, enter some data in your form and click Send:

Entering an example email into our form that contains a Hidden Field configured to automatically add new subscribers to the 'Arts' group upon submission Viewing the published form the user will see

We can then see the Arts group now contains a new subscriber:

Viewing the Mailchimp groups list with a new subscriber count visible in the 'Arts' group

Locating the new subscriber also displays the group they belong to:

Viewing the new Mailchimp subscriber status displaying their group of 'Arts'

Opt-In Permission

To maintain compliance with data processing laws like GDPR, CCPA, PIPEDA and DPA it may be appropriate to use our Opt-In feature to allow conditional subscribing. Users will consent to being added to your marketing list while filling out your form and are added as a subscriber if they agree.

If they don’t agree, your form result is still processed but they are not added to Mailchimp.

Our recommended field to use for this is the Yes/No Field, where the user can select a simple Yes or No choice to agree to be signed up:

Adding the Yes/No Field to our form which will be configured as the Opt-In trigger to conditionally add new Mailchimp subscribers Field type ‘Yes/No’ • Field Mapped to ‘opt_in’

Important: The value “Yes” needs to remain for this to work, so don’t rename the label within this field. This is due to us understanding the context as labels can be misleadingly named.

Create the connection to Mailchimp that the Yes/No Field is treated as the Opt-In, use the Field Mapper and add opt_in:

Adding the value 'opt_in' to our Yes/No field inside the Mailchimp Plugin's Field Mapper

If the user selects Yes they are added to Mailchimp. If they select No you still receive a form result, but no Mailchimp subscriber.

Alternatively, use the Consent Field as the Opt-In trigger, which is useful for giving data processing consent and email marketing opt-in notice:

Demonstrating the Consent Field with a short paragraph of text explaining the marketing permissions and opt-in Field type ‘Consent’ • Field Mapped to ‘opt_in’

The Multi-Select Field may also be used if desired, which would allow you to set the field as optional (as the Consent Field is Required at all times), however must only include one option:

Demonstrating the Multi-Select Field with a single option of 'Yes please!' to conditionally allow users to opt-in Field type ‘Multi-Select’ • Field Mapped to ‘opt_in’

Explainer: Only one option is allowed when using the Multi-Select Field due to the flexibility of the field and associating a selected item with what you intend to be a ‘Yes’ vote to opting a user in.

Adding Tags

Mailchimp supports adding “tags” to subscribers and the Mailchimp Plugin can be easily configured to add tags for each new subscriber. Tags are not created in Mailchimp, you create them dynamically from form field data or preset values.

You can configure tags using the same steps above, through either a Single-Select, Multi-Select, Dropdown or Hidden Field.

Option 1: Allow the user to select the tag(s).

We’ll demonstrate assigning a single tag via the Dropdown Field (for multiple tags use Multi-Select), in the Options list add each Mailchimp tag:

Adding a list of tag options to the Multi-Select Field

Create the connection to Mailchimp tags with the Field Mapper by entering tags as the value:

Entering 'tags' as the Map To value in the Mailchimp Plugin's Field Mapper

Click Save and Publish, then enter some data in your form and click Send:

Entering an example email and selecting 'CTO' as a Dropdown Field answer in our form Field type ‘Multi-Select’ • Field Mapped to ’tags’

Then view the new tags data within Mailchimp to confirm the connection:

Viewing the Mailchimp subscriber added with new tags

Option 2: Automatic tag(s) using a Hidden Field.

After adding the Hidden Field, click Edit and you’ll see Name and Value. Enter any unique name into the Name field, followed by the tag name inside the Value field:

Adding 'CEO' as the value inside the Hidden Field's 'Value' input box

For multiple tags simply comma separate the values, i.e. CEO, CTO

Create the connection to Mailchimp tags with the Field Mapper by entering tags as the value:

Entering 'tags' as the Map To value in the Mailchimp Plugin's Field Mapper

Click Save and Publish, then enter some data in your form and click Send:

Entering an example email in our form that has a Hidden Input containing a tag Field type ‘Hidden’ (not visible) • Field Mapped to ’tags’**

Then view the new tags data within Mailchimp to confirm the connection:

Viewing the Mailchimp subscriber added with new tags

That’s it! You can contact us for help anytime.