Skip to content
CMS Max Documentation

Mailchimp

Connect your website to Mailchimp for email marketing and audience management

Overview

The Mailchimp plugin integrates your CMS Max site with Mailchimp, a widely used email marketing platform. Once connected, form submissions on your site can automatically add subscribers to your Mailchimp audience, keeping your email lists current without manual data entry.

Setup

  1. Navigate to Settings > Plugins
  2. Find Mailchimp and click to open the settings page
  3. Click Save and Install

Getting Your API Key

  1. Log in to your Mailchimp account
  2. Go to Account > Extras > API keys
  3. Click Create a Key
  4. Name the key (e.g., "CMS Max")
  5. Copy the generated API key

Connecting Your Account

  1. Paste the API key into the API Key field in the plugin settings
  2. The Region field auto-fills from the API key (e.g., us10 or us20)
  3. Click Save
  4. Select your Campaign (audience list) from the dropdown
  5. Click Save again

Configuration

API Credentials

Mailchimp API credentials

Field Description
API Key Your Mailchimp API key (locked after initial entry)
Region Your Mailchimp data center region, auto-detected from the API key (e.g., us10)

Once credentials are saved and locked, use the Clear API Credentials and Disconnect account button to reset and enter new credentials.

Campaign Selection

Mailchimp campaign selection

Field Description
Campaign The Mailchimp audience (list) to add subscribers to. Use the refresh button to reload the list from Mailchimp.

How Form Submissions Are Sent to Mailchimp

When a form on your site includes an email field and has Mailchimp integration enabled, each submission automatically adds the email address to your selected Mailchimp audience. To enable this on a specific form:

  1. Go to Forms and edit the form
  2. Ensure the form has a field with type Email
  3. Enable the Mailchimp checkbox in the form's integration settings

If the email address already exists in the audience, it is skipped without creating a duplicate.

Troubleshooting

Campaign dropdown is empty

  • Verify your API key and region are correct
  • Click the refresh button next to the Campaign dropdown to reload the list from Mailchimp
  • Check that your Mailchimp account has at least one audience (list) created

Form submissions are not reaching Mailchimp

  • Confirm the Mailchimp plugin is installed and active in Settings > Plugins
  • Check that the Mailchimp checkbox is enabled on the specific form
  • Verify your form has an Email field type
  • Ensure a campaign is selected in the plugin settings

"The region is not reachable" error

  • Verify the region matches your Mailchimp account (visible in the URL when logged into Mailchimp, e.g., us10.admin.mailchimp.com)
  • If you recently changed API keys, clear the credentials and re-enter them