Troubleshooting the Embedded Signup Form

This feature requires Manager user level or higher.

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

Below, you'll learn about some common issues and suggested solutions.

Form shows no success or error messages.

The Classic Form embed code uses jQuery to validate the form and display response messages like the Almost Finished message that appears when they click the Subscribe button.

Subscribe success message

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 Almost Finished message, check for JavaScript conflicts on the page.

Subscribers land on Signup 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 Signup "thank you" page. To ensure JavaScript is turned on for your embedded form and update your site, follow the steps below.

  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. Choose Embedded forms.
  4. Click the Classic tab.
  5. Under Enhance your form, make sure the 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 click Submit, see the Signup "thank you" page, and receive an opt-in confirmation email. 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.

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.

  • The double opt-in process requires that new subscribers confirm their subscription. It's likely 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 <form> tag, copy the URL for the action property, and save it somewhere to use later.
  2. Delete the <form> tag and </form> tag.
  3. In the submit button code, add the code below. Make sure to replace actionurl with the action URL you copied earlier.

Was this article helpful?
What can we do to improve articles like this?

Technical Support