A Cozmoslabs Product

MailChimp

pb_addons_mailchimp

MailChimp Add-on allows users to subscribe to your MailChimp lists directly from the Register and Edit Profile forms. You can associate your MailChimp form fields with Profile Builder fields for each of your audiences.
You can choose whether your new users are subscribed automatically or must confirm their subscription through the double opt in option. Also you can select if your automatically subscribed users receive a welcoming email.

Activating the MailChimp Add-on

MailChimp is an Advanced add-on, available with a Profile Builder Basic, Pro, or Agency license only.

After purchasing a premium version of Profile Builder, you can check the following guide on how to install Profile Builder.

After the installation of the Basic, Pro, or Agency version, in order to activate The MailChimp Sync add-on, go to Dashboard → Profile Builder → Add-ons → MailChimp Add-on and click activate.

For the MailChimp add-on to work as expected, you’ll also need to have the following plugin installed and activated on your site:

Connect Profile Builder with MailChimp using the API key

In order to generate a MailChimp API key, you will need to login into your MailChimp Account.

In the lower-left side you will see your account -> Click on your name -> Profile -> Extras -> API keys -> Click on Create A Key.

Profile-Builder-MailChimp-API-Key

You will need to add and save the generated MailChimp API key in Profile Builder -> MailChimp in order to load your MailChimp Lists.

If you have multiple MailChimp audiences you will be able to select which of them the user is added to when creating the MailChimp Subscribe field.

Manage MailChimp Audiences and Fields

To create a MailChimp Audience you will need to login into your MailChimp Account and click on Audience. Here you will be able to create your first Audience by clicking on the “Create Audience” button.

Profile Builder - MailChimp - Create an Audience

After you click on the “Create Audience” button you will be able to set up and save your first MailChimp Audience.

Profile Builder - MailChimp - Setup Audience

After we save the MailChimp Audience we will see it on the Audience page.

Profile Builder - MailChimp - Created Audience

The next step is to set up the Signup Form. We can go to our Signup Forms if we click on Audience -> Signup forms.

Profile Builder - MailChimp - Singup Form
To set up a Signup Form you must verify that you have permission to send newsletters from the email address set inside Default From Email Address. You can verify the domain if you click on Website -> Domains -> Add & Verify Domain.

We will select the Form builder option for our MailChimp Audience. By default, the Signup Form has only a few fields. In most cases, this is sufficient when setting up a Newsletter but if you want to collect more user data we can add other extra fields.

lder - MailChimp - Setting up the Singup Form

Associate Profile Builder Fields with MailChimp Fields

If the API Key is valid then the “Monthly IT Newsletter” list will be loaded and you will be able to edit it. In the Edit Panel of a list, you will be able to associate each of the MailChimp Fields with Profile Builder Fields.

By default, the Email Address field from MailChimp is associated with the Default E-mail field from Profile Builder and this cannot be edited.

If your MailChimp list contains the First Name and Last Name fields, they will also be associated by default with their correspondents from Profile Builder. The Profile Builder Phone, Avatar and Birthday fields were created in Profile Builder -> Manage Fields.

Notes

  • If the Birthday Field in MailChimp uses the following date format: MM / DD we will need to set up our Datepicker field format to mm/dd in order to make it work
  • If MailChimp fields are set to be Required then we need to set Profile Builder’s fields to be required also

In the Edit Panel we can set Extra Options:

Double Opt-In Email Template

To customize the Double Opt-In Email template sent by MailChimp you will need to go to Lists -> Click on the List Name -> Signup Forms -> General Forms.

In the “Forms and response emails” drop-down select the Opt-in confirmation email.

Profile Builder - MailChimp - Double Opt-In Template

Enable GDPR

By enabling this option the following GDPR checkbox will appear on the front-end forms:

Profile Builder - MailChimp - Enable GDPR

For this checkbox to work correctly you must also enable the GDPR on the list from Mailchimp.

Associate Profile Builder Fields with MailChimp Groups

You may want to add users into certain MailChimp Groups, depending on the information they provide through Checkboxes, Radios or Select Drop-downs Fields, so that you can better segment your campaigns. To do this, you will have to associate MailChimp Groups with Profile Builder Fields, the same way as with field associations.

For example, lets say you have a Checkbox Field in your Signup form called Favorite Animals with 2 options: Dogs and Cats.

Profile Builder - MailChimp - Associate Groups

You will need to go to Profile Builder -> Manage Fields and add a checkbox field with the Field Title: Favorite Animals and in Options / Labels add: Dogs, Cats.

Now if you go to Profile Builder -> MailChimp -> Your list -> Group Associations -> Pair Favorite Animals with the Favorite Animals ( Checkbox ) created in Manage Fields.

MailChimp Subscribe Field

Once the add-on is active the MailChimp Subscribe field will be added to the fields drop-down in Manage Fields. Here you will select the list you wish your new users to be added to.

By default, the field shows both on Register forms and on Edit Profile forms, but you can hide it from the latter if you wish. Also, you can set it to be “Checked by Default”.

MailChimp Subscribe Field in the Registration Form

User Side

In the front-end part of your website, the field will be displayed as a checkbox. If the users check this option, when the registration is complete the data of the fields that have been associated with the MailChimp Fields will be sent to MailChimp and the new user will be subscribed to the list you have selected.

Profile Builder - MailChimp - Registration Form

Double Opt-In option

If the “Double Opt-In” option is checked then after Registration this is the email received by the user.

Profile Builder - MailChimp - Confirm Email Template

After clicking on the “Yes, subscribe me to this list.” button we will need to validate the reCAPTCHA in order to confirm our subscription.

Profile Builder - MailChimp - Validate reCAPTCHA

After confirmation users can continue to your website or manage their preferences.

Profile Builder - MailChimp - Subscription Confirmed

In the Manage Preferences section, users can update their data or Unsubscribe from the list.

Profile Builder - MailChimp - Update Preferences

Send Welcome Email option

If the “Send Welcome Email” option is checked then after Registration this is the email received by the user.

Profile Builder - MailChimp - Send Welcome Email option

Admin Side

When we created the Monthly IT Newsletter List we checked in the Notification section the “One-by-one” option. This is the email notification that we receive for each of our new subscribers.

Clicking on the View Subscriber button will take you to the user’s profile in MailChimp.

Profile Builder - MailChimp - Admin Email Notification

We will be able to view our subscribers if we login into our MailChimp Account and go to Audience -> All contacts.

Profile Builder - MailChimp - Number of Subscribers

If we click on the Audience Name we will be able to view each subscriber and their data.

Profile Builder - MailChimp - List Subscriber

Since the user checked in the Favorite Animals field the “Dogs” value we will see that user in the “Dogs” Group.

Profile Builder - MailChimp - Subscriber in Group

MailChimp Subscribe Field in the Edit Profile Form

Users can subscribe or unsubscribe from the list if they login and access the Edit Profile Form created by Profile Builder.

If users update their profile using the Edit Profile form, created by Profile Builder, the new data will be synced with MailChimp. Updating the profile in MailChimp will not modify the profile in WordPress.

Unchecking the Subscribe checkbox, in our case “Monthly IT Newsletter”, will unsubscribe the user from the MailChimp List.

Profile Builder - MailChimp - Edit Profile Form

MailChimp Widget

The add-on comes with a built-in widget that you can place in any widget area. By default, the widget has only the Email Address, First Name and Last Name fields from each list, and you can select which of these to display.

Profile Builder - MailChimp - Widget

If all three fields are selected, in the front-end part of your website, the widget will look something like the one below.

If inside your MailChimp List you have Extra Fields that are Required the Widget will not work. You will need to create a new list that uses only the default fields: Email, First Name and Last Name or use the existing list and make sure the Extra Fields are not Required.
Profile Builder - MailChimp - Widget in Frontend

If a field is required, on submission, the user will be prompted with an error.

Profile Builder - MailChimp - Widget in Frontend - Error

If everything worked fine, the user will receive a thank you message and will be subscribed to the list you have selected.

Profile Builder - MailChimp - Widget in Frontend - Success

How To

Set up a MailChimp Campaign

There are a lot of names for the email you send with MailChimp: mass email, newsletter but MailChimp calls each email message a “campaign“. MailChimp Campaign Builder walks you through building a campaign, step by step.

MailChimp covers a few basics about Campaigns in this article, including what you need to know before you start building a campaign, and an overview of the MailChimp Campaign Builder tool.

Import Users into MailChimp

In order to import users into your MailChimp list, you will need to follow this tutorial.

Resubscribe an Unsubscribed User

When a subscribed contact clicks the unsubscribe link in your MailChimp campaign, or when you manually unsubscribe a contact, the system assumes it was done on purpose and changes the contact’s email marketing status. But we know accidents happen, so there are a couple of ways to resubscribe a contact.

First, read the MailChimp Resubscribe a Contact article.

To resubscribe a user you will need to add inside your Widget Area the Profile Builder MailChimp Widget that is connected to your MailChimp list. Also, make sure to check the Double Opt-In option.

If inside your MailChimp List, you have Extra Fields that are Required the Widget will not work. You will need to create a new list that uses only the default fields: Email, First Name, and Last Name, or use the existing list and make sure the Extra Fields are not Required.

Basically, that user will need to resubscribe using the Widget.

MailChimp is an Advanced add-on, available only with a Profile Builder Basic or Pro license.

Get MailChimp – Profile Builder Add-on

The Ultimate Membership Bundle

Combine the power of Profile Builder with Paid Member Subscriptions to set up user registration, memberships, and recurring revenue.

Get 25% off with the bundle

Help & Support

We’re here to help you every step of the way.

Open a Support Ticket