Easy Forms for Mailchimp allows you to add unlimited Mailchimp sign up forms to your WordPress site. You can add forms to posts, pages, sidebars and other widgetized areas. Your Mailchimp API Key connects your site to your account and pulls in all of your list information. List statistics can be viewed right from your dashboard.
Check out some of our other plugins.
Alongside the default functionality of the plugin we’ve included a number of hooks and filters to allow for a higher level of customization of your forms.
Yes, you must have a Mailchimp account and at least 1 list set up in order to use the plugin. You can register for one for free at their website.
How does the plugin connect my Mailchimp account to my site?
Our plugin uses an API Key to allow your site to communicate with your account. After you enter your API key into the plugin settings your site is connected to your account and ready to make forms.
How do I create a Mailchimp API key?
Step-by-step instructions:
Click your profile name to expand the Account Panel, and choose Account.
Click the Extras drop-down menu and choose Mailchimp API keys.
Copy an existing API key or click the Create A Key button.
Name your key descriptively, so you know what application uses that key.
Copy your API key so you can paste it into the plugin General Settings.
The submit button text can be customized to use any text you like. This is done via the shortcode. Please visit our How-to article How do I change the submit button text for step-by-step instructions.
How do I add new fields to my form?
The fields that are assigned to a list are managed on the Mailchimp site. To add or remove fields you need to log in to your account and manage them there.
After you’ve added fields, they may not show up immediately in our plugin’s Form Builder. Our plugin pulls the information from your lists and stores it for a period of time before pulling it again. To get the new information immediately you will need to clear the Mailchimp API cache. Please read our article API Cache Settings for instructions on how to clear the Mailchimp API cache.
How do I change the field labels?
The text next to or above each field of a form is called a “label” and you may want to change them. For instance by default Mailchimp uses “First” instead of “First Name” and you may want to change it to make more sense. In the form builder, you will find a little pencil icon next to each form label. Click that icon to edit the label and hit the check icon to save it. After you are done editing field labels you will need to hit the “Update Form” button to save all of your changes.
I’m not seeing all my lists on the drop-down menu when I go to make a new form, why?
Our plugin fetches your list information from your account and stores it on your site in a cache. If you make changes to your lists, our plugin will update your site with those changes within an hour. If you want it updated immediately (for instance if you add a new list), you can delete the cache. Please read our Knowledge Base Article for more info.
Is there a way to display the number of subscribers for a given list?
Yes! You can use the shortcode, [yikes-mailchimp-subscriber-count] in the form description field to display the number of subscribers to that list.
To display the count for a specific list, you can use the form="#" or list="#" parameters. If using form="#" you should pass in a specific form ID, which will display the total number of subscribers associated with that form. If using list="#" you should pass in a list ID.
I want to use my own styles. Can I remove the styles bundled with this plugin?
Yes, we’ve included a constant you can use to prevent our styles from loading, YIKES_MAILCHIMP_EXCLUDE_STYLES. For usage, please see our Knowledge Base Article.
Some of the characters in my form are being stored as ??? instead of in the correct format.
You’ll want to make sure that your database collation is set properly. The best collation setting for all web languages is UTF8. If you need help switching collation settings in your database, please see the following article from Media Temple: Default MySQL character set and collation.
I’m having trouble upgrading to version 6, what do I do?
We want our users to have as smooth a transition as possible so we created Guides to Updating. Please check them out if you are experiencing problems.
Can I define my API key using a PHP constant, inside of wp-config.php?
Yes! Since version 6.1.2 we have enabled the ability to define a PHP constant inside of wp-config.php to be used throughout the plugin. The constant name you’ll want to use is YIKES_MC_API_KEY. Once you’ve defined your constant, you’ll want to head into the options page and save your settings for the changes to take hold.
Replace all instances of FILTER_SANITIZE_STRING with htmlspecialchars(). #917
6.8.9 – June 12, 2023
Escaped and sanitize form fields when a form is created and displayed to the user.
6.8.8 – March 27, 2023
Escaped and sanitize form fields in admin.
Fix block breaking bug with interest group form field descriptions.
Fix incorrect error returned when a form field submission data is reset.
6.8.7 – March 23, 2023
Altered code to adhere to WordPress Coding Standards.
6.8.6 – December 17, 2021
Addressed potential XSS vulnerability
6.8.5 – September 2, 2021
Deprecated filter block_categories is replaced by block_categories_all in WP 5.8
6.8.4 – April 12, 2021
Increase specificity of admin asset inclusion to prevent conflicts with other plugins.
6.8.3 – March 4, 2021
Rename assets folder
6.8.2 – February 17, 2021
Dropdown hotfix
6.8.1 – December 30, 2020
Added ‘yearRange’ to jQuery UI Datepicker Options
Thank you to @ptsteadman
6.8.0 – September 14, 2020
Added ‘Placeholder’ for dropdown.
Patched bug for checkbox interest group.
6.7.0 – July 1, 2020
Adding support for Google Recaptcha Version 3.
6.6.4 – March 26, 2020
Fixes “Freddie” logo image path.
6.6.3 – February 27, 2020
Important security release.
6.6.2 – November 3, 2019
Bug scrub WCUS! Fixed issues with adding tags on resubscribe.
6.6.0 – October 25, 2019
Adding Double Opt-in Subscribe.
Easy Forms Gutenberg Category – Thanks to @Ajwerth.
6.5.6 – October 24, 2019
Fixing bug with WordPress 5.3 ahead of release.
6.5.4 – August 28th, 2019
Patched security vulnerability found in on of our dependencies.
6.5.3 – July 1st, 2019
Added support for showing whether your site is being blocked by Mailchimp. If you’re blocked, you will now see an error on the plugin’s General Settings page.
Added a filter for our checkbox integrations, yikes_mailchimp_checkbox_integration_additional_vars. This allows you to use custom variables in our other filters.
Added a filter for changing the placement (above/below/both) of form error/success messages. See the filter yikes_mailchimp_feedback_message_placement.
Added support for setting the timestamp_signup Mailchimp merge variable to all new subscribers.
Removed support for setting the timestamp_opt variable for all subscribers. This plugin will no longer set the timestamp_opt Mailchimp merge variable.
Fixed an issue with default selected interest groups not working in our Gutenberg block.
Fixed admin input field code injection vulnerability. Thanks to Henri Salo from Nixu Corporation for finding and reporting this to us.
Fixed an error w/ error handling a failed API hit on the Manage Lists page.