WordPress.org

Ready to get started?Download WordPress

Plugin Directory

Easy MailChimp Forms

Easy MailChimp Forms allows you to painlessly add MailChimp sign up forms to your WordPress site and track user activity with interactive reports.

Do I need to have a MailChimp Account?

Yes, you can register for one for free at [MailChimp](https://mailchimp.com/sign up/ "MailChimp Signup").

Do I need to have lists already set up in MailChimp?

Yes, you have to have at least 1 list set up in MailChimp.

For more help, visit the MailChimp Support article How do I create a new list?

What do I do first?

The first step is to add your MailChimp API key. This will allow your site to communicate with your MailChimp account. This is done on the plugin "MailChimp Settings" page.

Where do I find my API Key?

From your MailChimp Dashboard, click on your account name in the upper left hand corner of the screen under the MailChimp logo to expose the "Account Settings" menu. Click on "Account Settings" to go to the Account Settings screen and the click on the "Extras" menu. Under "Extras" choose "API keys." From there you can create a new key if you do not already have one.

For more help, visit the MailChimp Support article Where can I find my API Key?

How to I add my MailChimp lists?

After you add your API key, the plugin will fetch all of your MailChimp list information and load it into the plugin admin. Go to the plugin "Manage List Forms" page to choose the lists you want to make forms for.

How do I add the MailChimp sign up forms to my site?

You can use a shortcode to add a form to a page or post, use the MailChimp form button in the visual editor or use a widget to add it to a sidebar. Each list on the plugin "Manage List Forms" displays a shortcode at the top. Copy the shortcode and paste it into any post or page where you want a form to appear. For example, if my form had the shortcode [yks-mailchimp-list id="1234567891"] I would copy and paste that into the page or post I wanted to add that form to.

I input a valid MailChimp API key, but it returns invalid every time. I've already tried a new API key, but no dice. What's up?

Step 1: Ensure that cURL is enabled at the server level. You will see an error at the top of the settings page if cURL is disabled. If you see no error, continue to step 2.

Step 2: If you have entered your MailChimp API key and are still getting the error "Error: Please enter a valid Mail Chimp API Key," please check the developer console inside your browser for further information.

  • Right-click in the API Key input field, and select 'Inpsect Element'
  • Once the developer console is open, select the Console tab to view a more specific error returned from the MailChimp API.

For information on how to use your browser's developer console, read the WordPress Codex article, Using Your Browser to Diagnose JavaScript Errors.

Possible Errors And Resolutions

  • Could not resolve host: xxxx.api.mailchimp.com - the host you have provided is incorrect. The host is the string after the last dash (example: us2)
  • Invalid Mailchimp API Key: xxxxxxxxxxxxxxxxxx-xxx - Your API key is invalid. You can confirm a valid key by logging into MailChimp and checking the active API key registered to your account.

I don't want the form to be the 100% width. How can I adjust the width myself?

You can adjust the width of the forms on your site by changing the width of the element with the class .yks-mailchimpFormContainer. This is the parent container for the form. Adjusting this width will control the width of the input fields inside of it.

How can I translate this plugin?

Easy MailChimp Forms is now translated into multiple languages:

  • Arabic
  • Chinese
  • English
  • French
  • German
  • Greek
  • Hebrew
  • Hindi
  • Hong Kong
  • Italian
  • Japanese
  • Korean
  • Persian
  • Portuguese (Brazilian)
  • Portuguese (European)
  • Romanian
  • Russian
  • Spanish
  • Swedish
  • Taiwanese
  • Tamil
  • Urdu
  • Vietnamese
  • Welsh

Read the Codex article Installing WordPress in Your Language for more information. Also, please refer to our Developer Docs.

Do you provide any hooks, or filters for me to take advantage of?

Yes! With the 4.0 version of our plugin we have added a few hooks that allow you to add or manipulate existing data. Check out the Other Notes tab for more information.

Do you offer integration with reCAPTCHA? I keep getting spam entries from bots and spammers.

Yes! Since version 4.4 of Easy MailChimp Extender, we have added reCAPTCHA support. You can sign up for a reCAPTCHA API key here. You will need to provide your public key as well as the private key. Don't worry, its free :)

When I input my API key and hit save, it immediately reverts to a much shorter string of text and returns invalid. What's going on?

You most likely have a password manager installed and active (LastPass, OnePass, TeamPassword etc.). The API key input field is set to type="password" for security reasons. Most password managers auto-fill password fields based on the URL of the current page. So, what happens when you click save is that the password manager auto fills in the field with the password that you have saved for your site, and thus returning 'invalid API key'. To resolve the issue you'll need to temporarily disable any active password manager and re-enter and save your API key. Once the key has been successfully saved, you can re-enable your password manager.

Requires: 3.0 or higher
Compatible up to: 4.0
Last Updated: 2014-8-28
Downloads: 46,104

Ratings

4 stars
4.4 out of 5 stars

Support

20 of 20 support threads in the last two months have been resolved.

Got something to say? Need help?

Compatibility

+
=
Not enough data

1 person says it works.
0 people say it's broken.

100,4,4 100,2,2 100,1,1
100,1,1
0,2,0 100,1,1 100,2,2
100,1,1
0,1,0
100,3,3 100,4,4
100,4,4
100,3,3
100,2,2 100,2,2
100,1,1
100,1,1 100,2,2 100,1,1 100,2,2 100,5,5 67,3,2 100,2,2 100,2,2 100,2,2 100,2,2 100,1,1
100,2,2 100,1,1