On this page
Mailchimp Module: Introduction
Note: more documentation for the Mailchimp module is available in the README files of the submodules.
About
The Mailchimp module integrates with Mailchimp, the popular email delivery service. It is available for Drupal 6 - 9, although Drupal 6 is no longer supported and Drupal 7 is security-fixes-only at present.
Features
- Create subscription forms for any Mailchimp list and display as a Block and/or Page, with myriad configuration options.
- Enables logged-in users to manage their subscriptions from their account page.
- Allows users to subscribe to lists during registration.
- Map user tokens to Mailchimp merge fields.
- Allows subscriptions to be maintained via a batch process during cron or in real time.
- Optionally enable list "interest group" subscriptions, for more fine grained mailing list control.
- Integrate with the Mailchimp Events API to track user interactions with Webforms (or other events) in Mailchimp. (as of 2.1.x)
Installation Notes
All versions of Mailchimp require a version of the Mailchimp PHP library. If using Drupal 7, there is a makefile example for how to pull down this library, plus instructions in the README. For all versions, it is recommended that you install the module using composer, which will automatically retrieve the necessary library.
Enabling the "Mailchimp" module alone won't do much other than allow you to configure your connection to Mailchimp. To get additional features, enable the submodules:
- Audiences (formerly "lists") -- Use this to attach signups to Users or other Drupal entities, where the entity or User is the one being subscribed using a (required) email field.
- Signup -- Use this to create signup blocks or pages.
- Campaign -- Use this to generate campaigns in Mailchimp using content on your Drupal site.
- Events -- (introduced in 2.1.x) Create events in Mailchimp based on user interactions, especially Webform submissions.
Configure
- Configure the module at Administration > Configuration > Web services > Mailchimp (/admin/config/services/Mailchimp)
- Enter a Mailchimp API key
Tips
- Don't use test@example.com when testing Mailchimp; it's an invalid address and Mailchimp is good at validation so the tests will fail.
- Mailchimp has a TON of additional resources and documentation on their site at https://mailchimp.com/resources
More information
For support, questions, feature requests etc:
- checkout the Mailchimp FAQ page
- use the Mailchimp issue queue
- visit Drupal Answers
Help improve this page
You can:
- Log in, click Edit, and edit this page
- Log in, click Discuss, update the Page status value, and suggest an improvement
- Log in and create a Documentation issue with your suggestion