How to debug MailChimp error


This document provides instructions on how to detect and debug errors, that may appear when member subscribes to the MailChimp audience using the MailChimp extension.


Debugging #

Update plugins #

Update "Ultimate Member" and "Ultimate Member - MailChimp" plugins to the latest version. You can update plugins automatically or manually from the archive.

Image 01 - How to update plugin automatically

Plugins, Installed Plugins

How to update plugin manually from the .zip archive

  • go to the admin page "Plugins"
  • deactivate old version (if it is)
  • delete old version (if it is)
  • click the "Add New" button
  • click the "Upload Plugin" button
  • click the "Choose file" button - additional window should appear
  • select an archive with the new version
  • click the "Install Now" button - installation will start
  • activate plugin after the installation

Please look to the documentation for details.

Enable requests log #

The extension may save requests to the MailChimp server to the file  /wp-content/uploads/ultimatemember/mailchimp.log. Turn on the setting Enable requests log to enable this feature.

Image 02 - The page [Ultimate member > Settings > Extensions > MailChimp]

Verify audience and connection settings #

Synchronization between Ultimate Member and MailChimp fails if the required field is empty. 

Synchronization between Ultimate Member and MailChimp may fail if the value of the "radio buttons" or "drop-down" field type doesn't match the audience field options.

The widget Merge User Meta has several tools that help you to configure fields relationship and avoid mistakes:

  • required fields marked by the icon!
  • additional information about field type and choices may be seen under the icon?
  • a warning appears under the field if the configuration is wrong

Image 03 - The widget Merge User Meta on the page [Ultimate Member > MailChimp > Edit audience]

Image 04 - A warning in the widget Merge User Meta

Ultimate Member, MailChimp, Edit audience

Try to subscribe and unsubscribe members from the Account page #

Error message appears on the Account page if the update fails for some reason. Verify your audience and connection settings. Pay attention to the widget  Merge User Meta, especially on required fields and choices for the "radio buttons" and "drop-down" field types.

Image 05 - An error message on the page [Account > Notifications]


Investigate the Requests log #

The extension may save requests to the MailChimp server. You can overview the Requests log on the extension's settings page. Use the log to debug MailChimp API errors. Requests with errors are colored in red. Usually, you may find the error detail in the RESPONSE data.

Image 06 - An error detail in the Requests log on the page [Ultimate member > Settings > Extensions > MailChimp]

MailChimp errors #

Forgotten Email Not Subscribed #

MailChimp doesn't allow re-subscribe permanently deleted contacts by API. You have to go to your MailChimp account and re-subscribe to this contact manually.

Note: We don't recommend using the action "Permanently delete" on account removal. Read the article MailChimp Setup for details.

Image 07 - The error message "Forgotten Email Not Subscribed"

Member In Compliance State #

MailChimp adds an email address to the black list if a member uses the link "unsubscribe from this list" in the email footer. 

Image 08 - The unsubscribe link

This email address can't be resubscribed via API. You should see an error message if you try to resubscribe using fields in the account tab Notifications.

Image 09 - The error message "Member In Compliance State"

We can't influence this logic from the site. A member can resubscribe by clicking the button "Subscribe" in the email "You are now unsubscribed" that Mailchimp sends after the contact is unsubscribed.

Image 10 - The email "You are now unsubscribed"