Mailchimp Lists

Last updated on
5 August 2021

Mailchimp Lists is a submodule of the Drupal 7 and Drupal 8 versions of the Mailchimp module. It allows synchronizing Drupal users with Mailchimp lists and it allows users to subscribe, unsubscribe, and update member information.

8.x and 7.x-4.x

Once your Mailchimp API key has been added to the Global Settings configuration page (admin/config/services/Mailchimp), your Lists will populate automatically. To see your lists, visit the Lists tab (admin/config/services/Mailchimp/lists).

7.x-2.x and 7.x-3.x

Don't use these branches. Use the 7.x-4.x branch instead.

Settings

Lists are exportable and have a machine name so they can be exported with Features

Enable Mailchimp webhooks for this list
When a user unsubscribes from a list or updates their profile outside of Drupal, Mailchimp will trigger an event to update the user's cached Mailchimp member information. This will not update any of their Drupal user information.

Required lists

Required lists can be setup by using the Rules module. More information on how to set this up can be found on the FAQ page.

User subscription management

To add a subscribe option for registered users, add a Mailchimp Subscription field to a users Account settings page (admin/config/people/accounts). See the FAQ page for more info.

Free form lists

This is the only type of list allowed for the Anonymous role and has the following options. Signup forms can be created by clicking on the Signup Forms tab, or visiting this path: admin/config/services/Mailchimp/signup

Subscription Settings

Require subscribers to Double Opt-in
New subscribers will be sent a link with an email from Mailchimp that they must follow to confirm their subscription.
Include interest groups on subscription form.
If set, users will be able to select applicable interest groups when registering or editing their accounts. Interest Groups are set up in Mailchimp. Read more about Mailchimp Groups.

UI Changes since 7.x-3.x

The module user interface has been changed in version 7.x-3.x as follows:
"Lists and Users" tab at admin/config/services/Mailchimp
Label changed to "Lists"
"add a list"
Link has been removed. List titles are now downloaded from the Mailchimp site with the "Refresh lists from Mailchimp" function
List Parameters
All parameters have been removed from the "Lists" page. Instead, the Mailchimp list has become a field type that can be added to entities. For example, to specify parameters for a subscription option that is to appear on the user registration page, navigate to admin/config/people/accounts/fields and add a field of type "Mailchimp Subscription", then complete the associated form to specify its parameters.
Eliminated Parameters
The following parameters from version 7.x-2.x have been eliminated in 7.x-3.x, and equivalent functionality must be implemented in a different manner: allow anonymous registrations, automatically add all users, selective Roles, sync list during cron, webhooks, Submit Button Label

Help improve this page

Page status: No known problems

You can: