Note: Integrations must be set up by a Toolkit admin. To connect any of the integrations below, contact support and let us know which integration you'd like added to your account.

MailChimp Integration

Connect Popup with MailChimp to manage subscribers, lists, groups, tags, and custom fields from your widget submissions.

Connecting MailChimp to Popup

There are two ways to connect:

Option 1: Account Login

1. In your Popup dashboard, go to your site's Integrations settings
2. Select MailChimp from the list
3. Click Connect with MailChimp
4. Log in to your MailChimp account and authorize access

Option 2: API Key

1. In MailChimp, go to Profile > Extras > API keys
2. Generate or copy an existing API key
3. In Popup, paste the API key in the MailChimp integration settings

Integration Settings

After connecting, configure these options:

• Filter lists to site -- limit which MailChimp lists (audiences) are available in the widget editor
• Double opt-in -- toggle whether subscribers must confirm via email before being added
• Default list -- select the default audience for new subscribers

Auto Field Mapping

Popup automatically maps your widget form fields to matching MailChimp merge fields. If a field name matches a MailChimp field, the mapping is set up for you.

Configuring Your Widget

Once connected, open your widget editor and configure the submit actions.

Available Actions

• Subscribe to list -- add the contact to a MailChimp audience
• Remove from list -- unsubscribe the contact from an audience
• Add to group -- add the contact to an interest group within an audience
• Remove from group -- remove the contact from an interest group
• Add tag -- apply a tag to the contact
• Remove tag -- remove a tag from the contact
• Update custom field -- set or update a merge field value
• Add note -- attach a note to the contact record

Display Rules

Use Display Rules to show or hide widgets based on whether a visitor is already subscribed to a specific MailChimp audience or belongs to certain groups. This prevents showing opt-in forms to existing subscribers.

Visitor Identification

To identify returning visitors by email (for personalized Display Rules), append the email merge tag to your URLs in MailChimp emails:

?conv_email=*|EMAIL|*

When a subscriber clicks through from a MailChimp email, Popup recognizes them and applies the appropriate Display Rules.

Need more help?

If you've worked through this and still need a hand, contact support -- we'll dig in with you.