Description

Use the MailChimp List Subscribe plugin to quickly add a MailChimp signup form widget to your WordPress 2.8 or higher site.

After installation, you’ll log in with your API key, select your MailChimp list, choose merge fields and groups, and add the widget to your site. Typically, installation and setup will take about 5-10 minutes, and absolutely everything can be done via the WordPress Setting GUI, with no file editing at all.

WordPress.com compatibility is limited to Business tier users only. How to add a signup form if you have a WordPress.com site.

Upgrading

If you are upgrading to version 1.2.1 and you used the widget in your sidebar previously, all you need to do is drag the MailChimp Widget back into the sidebar, visit the MailChimp settings page (which will have maintained your prior settings), click the “Update List” button, and you’re done!

Internationalization (i18n)

Currently we have the plugin configured so it can be easily translated and the following languages supported:

bg_BG – Bulgarian in Bulgaria (thanks to SiteGround for contributing)
cs_CZ – Czech in the Czech Republic (thanks to Peter Kahoun for contributing)
da_DK – Danish in Denmark (thanks to Jan Lund for contributing)
de_DE – German in Germany (thanks to Michael Jaekel for contributing)
el_GR – Modern Greek in Greece (thanks to Ιωάννης Δημοφέρλιας (John Dimoferlias) for contributing)
en_US – English in the U.S.
es_CL – Spanish in Chile (thanks to Tomás Nader for contributing)
es_ES – Spanish in Spain (thanks to Claudia Mansilla for contributing)
et_ET – Estonian in Estonia (thanks to Helen Urbanik for contributing)
fr_FR – French in France (thanks to Maxime Toulliou for contributing)
he_IL – Hebrew in Israel (thanks to שגיב בית for contributing)
hu_HU – Hungarian in Hungary (thanks to Okostobi for contributing)
it_IT – Italian in Italy (thanks to Stefan Des for contributing)
ko_KR – Korean (thanks to 백선기 (SK Baek) for contributing)
nb_NO – Norwegian (thanks to Alexander Roterud aka Defrag for contributing)
nl_BE – Dutch (thanks to Filip Stas for contributing)
pt_BR – Portuguese in Brazil (thanks to Maria Manoela Porto for contributing)
pt_PT – Portuguese in Portugal (thanks to Tiago Faria for contributing)
ro_RO – Romanian in Romania (thanks to Alexandru Armin Roșu for contributing)
ru_RU – Russian in the Russian Federation (thanks to Илья for contributing)
sv_SE – Swedish in Sweden (thanks to Sebastian Johnsson for contributing)
tr_TR – Turkish in Turkey (thanks to Hakan E. for contributing)

If your language is not listed above, feel free to create a translation. Here are the basic steps:

Copy “mailchimp_i18n-en_US.po” to “mailchimp_i18n-LANG_COUNTRY.po” – fill in LANG and COUNTRY with whatever you use for WPLANG in wp-config.php
Grab a transalation editor. POedit works for us
Translate each line – if you need some context, just open up mailchimp.php and search for the line number or text
Fork the repository on github
Clone the develop branch
Add the appropriately named files to the /po/ directory and edit the /readme.txt to include how you’d like to be attributed
Make a pull request

Screenshots

Entering your MailChimp login info
Selecting your MailChimp list
Configuring your Signup Form display format (optional)
Configuring extra fields on your Signup Form (optional)
An example Signup Form Widget

Installation

This section describes how to install the plugin and get started using it.

Version 2.8+

Unzip our archive and upload the entire mailchimp directory to your /wp-content/plugins/ directory
Activate the plugin through the Plugins menu in WordPress
Navigate to Settings click MailChimp Setup.
Enter your MailChimp API Key and let the plugin verify it.
Select the list where you want to send new MailChimp subscribers.
Optional: turn MonkeyRewards on or off.
Optional: Turn Merge Fields and Groups on or off. Navigate to Appearance, and click Widgets. Drag the MailChimp Widget into one of your Widget Areas.

Advanced

If you have a custom coded sidebar or bells and whistles that prevent enabling widgets through the WordPress GUI, complete these steps instead.

WordPress v2.8 or higher:
[mailchimpsf_form]

If you are adding it inside a php code block, pop this in:

 mailchimpSF_signup_form();

Or, if you are dropping it in between a bunch of HTML, use this:

<?php mailchimpSF_signup_form(); ?>

Where ever you want it to show up.

Note: in some environments you will need to install the Exec_PHP plugin to use that method of display. It can be found here: https://wordpress.org/extend/plugins/exec-php/

Reviews

wyverndryke 15 January 2023

This plugin does not help you incorporate MailChimp into your WordPress site, at all.

ericksonstudio 14 June 2022 1 reply

If you have PHP version 8.0 or above on your website, you will receive the following message ONLY if you have the Javascript option OFF in the MailChimp plugin settings — if you don't have the Javascript option on, the form won't work and you won't receiving any error messages indicating why: Warning: Undefined array key "phone_format" in .../wp-content/plugins/mailchimp/mailchimp.php on line 861 Downgrade to PHP 7.4+ if possible and it will work again. In the meantime, MailChimp really needs to up their game since WordPress+MailChimp integration is important to many, otherwise you'll telling us to move to Constant Contact, et cetera.

leotuorto 4 May 2018

Upon installed it locked my admin and had to uninstall it by deleting plug-in files using my server file manager

Oleg 18 February 2018 1 reply

Does not support multiple forms. Only one mailchimp list can be connected.

danba 11 August 2017

I rarely give bad reviews but on this plugin I was disappointed. Mailchimp is an awesome services and yet they did not maintain, fix and improve this plugin. Now if they release a new version, which should include bug fixes and maybe some simple page level Targeting of widget, I would happily test again and revise my review.

gotwickdotcom 7 June 2017 1 reply

Using Twenty Seventeen theme, when I add this widget to a page, it has a dot, like a bullet point, at the top of the form. I tried and tried to remove it, but no luck. No other widget does it that I have found. Any suggestions?

Read all 72 reviews

Contributors and Developers

“MailChimp List Subscribe Form” is open source software. The following people have contributed to this plugin.

Mailchimp

Translate “MailChimp List Subscribe Form” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Change Log

1.5.8

Fix PHP warning for merge tags.
Fix double slashes on resoures being loaded
Update Readme.txt link

1.5.7

Fix undefined variable notice.
Fix HTML submission message.

1.5.6

Fixes short array notation which caused a fatal error in older PHP versions.

1.5.5

Fix timeout error on activation.

1.5.4

Set optional value for API wrapper.

1.5.3

Fix PHP7 compatibility issue
Cut down on size of API requests for users with large lists.
Fix CSS issue on removing MailChimp style.

1.5.2

General bugfixes for merge fields.
When reinitializing, update merge field values.

1.5.1

Bugfix for fatal error in MailChimp lib

1.5

Upgrade to MailChimp API v3.0
Remove OAuth2 middle layer and use MailChimp API keys
Include double/single opt-in toggle.

1.4.1

Update styles to be compatible with upcoming 3.8 wp-admin changes

1.4

Developer Mode “Kitchen Sink” takes over plugin for local development
Developer Mode has filters of changable content
Fix bug related to required US phone validation

1.3

Now using OAuth flow for user authentication
Admin UI refresh

1.2.14

Add link to edit profile within error when duplicate signup occurs

1.2.13

Fixed bug preventing address fields from submitting correctly.

1.2.12

Update spanish language files (es_ES and es_MX)

1.2.9

Fixed bug where multiple checkbox type interest groups were returning an invalid error
Fixed bug where assets were not enqueueing properly if the plugin directory was not set to ‘mailchimp’. Now supports any directory name.

1.2.8

Fixed bug where entire phone numbers were only being deposited in the area code portion

1.2.7

CSS should now always load correctly on the front end
Adding Hebrew and Romanian language support
Updating translation contribution instructions
Tested version is now 3.3.1

1.2.6

Fixed bug with “Settings” link appearing on all plugins (props Jason Lane)
Resolved issue with unnecessary calls to the MailChimp API during upgrade check
Resolved PHP warning when there weren’t any interest groups

1.2.5

Field formatting based on type
Support for multiple interest groups (a data upgrade procedure must be run by visiting the WordPress dashboard)
Added jQuery datepicker option to be used with dates.
Added a handful of new translations
Fixing various PHP notices and deprecated functions (props Jeffry Ghazally)

1.2.4

Version bump for proper listing on wordpress.org

1.2.3

Change mailchimpSF_where_am_i() to use plugins_url() in place of WP_PLUGIN_URL to take SSL into account when delivering assets (props John LeBlanc)
Update MCAPI wrapper to bring back PHP4 support (note: PHP 5.2 to be required starting with WordPress 3.2)

1.2.2

Change MCAPI wrapper to use a more unique class name, v1.3 of the API, and a much lighter client library

1.2.1

Fixed internationalization path bug.
Fixed instances where i18n functions weren’t necessary in admin.
Added more strings to be translated.

1.2

Recommended Upgrade, please see “Upgrading” section of readme.
Security and various other improvements

Almost worthless.

Needs an update BADLY! It’s not compatible with PHP 8+

Very unstable, not working properly

Only one form supported! No way!

Not recommended unlike Mailchimp

Works great, just a tiny detail that annoys me…