Troubleshooting the Embedded Signup Form

If you want to add a signup form to your website, we offer a simple signup form embed code that uses CSS and JavaScript. Since every website is unique, it's possible that you'll encounter conflicts between our code and yours.

In this article, you'll learn how to resolve some common issues with embedded signup forms.

My form shows no success or error messages.

The Classic Form embed code uses jQuery to validate the form and display response messages like the success message that appears when someone clicks the Subscribe button to sign up to your list.

This action is managed by JavaScript, which is particular about what other actions are being performed on the page. Sometimes, multiple scripts on a page can block one another from working correctly. If you don't see the success message, check for potential JavaScript conflicts.

Subscribers land on Confirmation Thank You Page.

Form actions are managed by JavaScript, so if that's turned off, you may see the form behave erratically. For example, your subscribers may not see dynamic response error or success messages, or they'll be taken to the Mailchimp hosted Confirmation "thank you" page.

To ensure JavaScript is turned on for your embedded form and to update your site, follow these steps.

1. Navigate to the Lists page.
2. Click the drop-down menu next to the list you want to work with, and choose Signup forms.
3. Select Embedded forms.
4. Click the Classic tab.
5. In the Enhance your form section, make sure the box next to Disable all Javascript box is unchecked.
6. In the Copy/paste into your site field, highlight all the code and copy it to your clipboard.
7. Paste it into your website to replace the current version of your form.

Subscriber submits and goes to Signup Form With Alerts.

If your embedded form is directing subscribers to the hosted version of your Mailchimp Signup form with alerts, look for required fields that have been hidden on your signup form or deleted from the form code.

For example, if your signup form includes a First Name field that is required, but it's been hidden or deleted from the embed code, this can cause the form to submit to the hosted form with errors after someone attempts to subscribe.

To check each field's settings, navigate to the Form Builder for the list you're working with. If you find a field marked required and hidden, it is probably the cause of this issue. If you're comfortable with custom coding, you can also View Source on your embedded form, and check the code for the following string.

input type="hidden"

Nothing happens after someone clicks Submit.

Typically, a subscriber should submit your form and see a success message that indicates that they've been added to your list. If there are errors in their submission, they would see an error message. If none of these things happen, our servers may not have received the form.

This typically occurs when there are multiple forms using JavaScript validation on a single page of your website. We recommend creating individual pages on your website for each signup form you need.

If you need to have more than one embedded form on a single web page, use one of these solutions.

• Disable JavaScript on the Classic form.
• Embed your Classic form in an iFrame.
• Display your embedded form as an Unstyled, Condensed, or Horizontal form type.

Subscribers got success message but aren't on my list.

Two issues can cause this result. One is on the user's end, and one could have to do with your form code.

• If you use the double opt-in process, new subscribers must confirm their subscription via email before they can be added to your list. It's possible that these subscribers haven't completed the process yet. Ask if they have received the Confirmation email, and whether they have checked their spam or junk folders.
• If you edited the embed code before you pasted it into your website, double check that the form submits data to the correct Mailchimp account and list. When in doubt, replace the code on your site with the generated embed code in Mailchimp.

The Subscribe button is missing.

If you're using a content management system like Wordpress or Wix, it's possible that your subscribe button may not appear because of CSS conflicts. To resolve the conflict, edit the embedded form code.

The embedded form code doesn't work with ASP.NET.

ASP.NET pages and the Mailchimp embedded form code both include form tags. These form tags conflict and prevent the ability to submit new subscriber data to your list. You'll need to change the embedded form code for it to work on your ASP.NET page. We've seen the code change below help some users, but we can't guarantee that it will work for your site.

1. In the Mailchimp embedded form code, find the tag, copy the URL for the action property, and save it somewhere to use later.
2. Delete the tag and tag.
3. In the submit button code, add the code below. Make sure to replace actionurl with the action URL you copied earlier.

onClick=this.form.action='actionurl';this.form.submit();

Form shows “too many subscribe attempts”

If your embedded form shows the "Too many subscribe attempts for this email address" error, you may need to turn off the autofill feature in your internet browser.

To fix the error, turn off autofill and try again in about five minutes.