JavaScript form events

Mailchimp for WordPress triggers various JavaScript events whenever your visitors interact with a sign-up form on your site. These events can be used to run custom code, for example to track form sign-ups with Google Analytics.

You can include this code directly in the form editor if you like. The mc4wp reference is only registered on pages where our form is inserted via a shortcode or widget.

Available form events

The following event names are available.

started fired once user starts filling in a form
submitted fired once user submits form
error fired if form is submitted with errors
success fired if form is submitted successfully
subscribed fired if form is used to subscribe
unsubscribed fired if form is used to unsubscribe
updated_subscriber fired if form was used to update an existing subscriber

Hooking into a form event

The following code hooks into the “success” event. This example simply writes something to the browser’s console, but you can run whatever code you want in the function callback.

<script type="text/javascript">
mc4wp.forms.on('subscribed', function(form) {
  // gtag.js
  gtag('event', 'Sign-up', {'event_category': 'Mailchimp', 'event_label': 'Name: ' + form.name + ' ID: ' + form.id});

Hooking into one specific form

The above code will trigger whenever any form on your website is successfully submitted. If you want to limit this to a certain form, prefix the event name with the numerical form ID followed by a dot.

mc4wp.forms.on('15.success', function(form, data) {
   // your code goes here
   console.log("Form with ID 15 successfully submitted.");