WordPress.org

Ready to get started?Download WordPress

Plugin Directory

Easy MailChimp Forms

Easy MailChimp Forms allows you to painlessly add MailChimp signup forms to your WordPress site.

Do I need to have a MailChimp Account?

Yes, you can register for one for free at MailChimp.

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 signup 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 see a more specific error.

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.

Requires: 3.0 or higher
Compatible up to: 3.9.1
Last Updated: 2014-6-9
Downloads: 34,383

Ratings

4 stars
4.2 out of 5 stars

Support

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

Got something to say? Need help?

Compatibility

+
=
Not enough data

2 people say it works.
1 person says 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