Back to Community
Home / Community / Plugin → Maintenance

Troubleshooting MailChimp and Email Subscription Issues in the Maintenance Plugin

20 threads Sep 16, 2025 Plugin → Maintenance

Content

Many WordPress users rely on the Maintenance plugin to display a holding page while their site is being updated. A common and powerful feature is the ability to integrate with email marketing services like MailChimp to build a subscriber list. However, as seen in numerous community threads, getting this integration to work correctly can be frustrating.

This guide will walk you through the most common problems and their solutions, helping you collect those valuable email addresses without a hitch.

Common MailChimp & Subscription Problems

Based on community reports, the typical issues users face include:

  • The subscription form shows a red 'X' or error when submitted.
  • Emails are not being sent to the specified MailChimp list.
  • Inability to find the MailChimp integration settings.
  • Confusion over how to customize the subscription message or button text.
  • The desire to add extra fields (like a name or ZIP code) to the form.

Why These Problems Happen

These issues generally occur for a few key reasons:

  1. Plugin Scope Confusion: The free version of the Maintenance plugin does not include built-in email subscription forms. This functionality is part of the 'Maintenance Pro' version. Attempting to use shortcodes from other plugins (like MailPoet or Contact Form 7) will not work because the Maintenance page deliberately does not load other WordPress plugins to prevent conflicts and errors.
  2. Incorrect API Configuration: For the Pro version's integration to work, the MailChimp API Key and List ID must be entered exactly correctly in the plugin's settings.
  3. Feature Limitations: The plugin's built-in form is designed for simplicity. By default, it only collects an email address. Adding custom fields like name, last name, or ZIP code is not possible through the standard settings and requires custom development.

Step-by-Step Troubleshooting Guide

1. Verify Your Plugin Version

First, confirm which version of the Maintenance plugin you are using.

  • Free Version: This version does not have a built-in email subscription form. Community threads show that attempting to use shortcodes from other form plugins will simply display the code as text and not a functioning form. Your options are:
    • Upgrade to the Pro version for native MailChimp/Campaign Monitor integration.
    • Use a different maintenance plugin that includes a basic email capture form.
    • Manually add a link to an external MailChimp signup page and style it with CSS to look like a button.
  • Pro Version: If you have the Pro version, ensure it is updated to the latest version. The 'Email Lists' settings tab under 'General Settings' is where you will configure your MailChimp integration.

2. Check Your MailChimp API Settings (Pro Version)

If your form is showing an error like a red 'X', double-check your configuration:

  1. Log into your MailChimp account and generate an API key.
  2. Find the Audience ID (List ID) for the specific list you want to use.
  3. In your WordPress dashboard, navigate to Maintenance > General Settings > Email Lists.
  4. Select 'MailChimp' as your service.
  5. Carefully copy and paste your API Key and List ID into the corresponding fields. Avoid adding any extra spaces before or after the strings.
  6. Save your changes and clear your site's cache if you use a caching plugin.

3. Customizing Text and Messages

You can customize the text displayed on the form:

  • The 'Maintenance' team has added a field for customizing the MailChimp message (e.g., "be the first to know") in version 2.3 and later. Ensure your plugin is updated, and look for this text field in the settings.
  • Changing the 'Subscribe' button text is more technical. Community support indicates this typically requires modifying the plugin's source or translation files, which is not recommended for most users as changes may be overwritten by updates.

4. Understanding the Limitations on Custom Fields

A frequent request is to add fields for a subscriber's name, last name, or ZIP code. It is important to understand that this is not a standard feature of the plugin. As confirmed in multiple threads, this is only possible through custom development work on the plugin's code. The 'Maintenance' support team has stated they can provide estimates for such customization projects.

5. The Subscription Success Message

Some users report that the success message (a small pop-up) is easy to miss. While the community threads did not provide a direct setting to change this, the pop-up is likely styled with CSS. A knowledgeable user could potentially override the default styles with custom CSS to make it larger or more prominent.

By methodically working through these steps, you should be able to resolve the most common issues preventing your Maintenance page from successfully capturing email subscribers.

Related Support Threads Support