1. Home
  2. Documentation
  3. 3rd Party Integrations
  4. MailChimp Integration

MailChimp Integration

The MailChimp integration allows syncing user and/or customer emails directly with your MailChimp lists whenever certain events occur within your plugin or theme. Syncing the emails with your MailChimp is super easy!
It doesn’t require any coding and only takes a few minutes:

  1. Login to your Freemius dashboard and go to INTEGRATIONS -> MAILCHIMP:
    Freemius Dashboard MailChimp Integration Menu Item
  2. Connect your Freemius plugin or theme with your MailChimp account:
    Connect Freemius with MailChimp Button
  3. Click on Create New Rule.
  4. Tick the event types with which you would like to trigger the emails sync:
    Freemius User Events
    You can access the documenation of the events collection here.
  5. Select the MailChimp list you’d like to sync the emails to.
  6. If you prefer to sync the emails with any specific group, choose the group category and group.
  7. Choose whether you’d like the rule to add the email to the list or remove it from the list:
    Add or remove email from MailChimp’s list
  8. Finally, don’t forget to click save.

MailChimp + Freemius Best Practices

MailChimp’s pricing is based on the number of subscribers in all lists combined. When the same email address is included in multiple lists, it counts as multiple subscribers. Therefore, whether you are selling a single plugin/theme, or have a shop with multiple products, in most cases, setting up a single list for all of your subscribers is good enough and a great way to save some money. Then, you can leverage MailChimp’s groups and categories to associate the subscribers with their respective prodct(s) and target your email marketing campaigns at the right people.

A Step-By-Step List and Groups Configuration

  1. Go to MailChimp and login.
  2. Create a list named My WordPress Shop (or any other name).
  3. Under the list management, go to Manage Contacts → Groups, and click Create Groups.
  4. Use your product’s name for the Group Category (e.g. My Awesome Plugin).
  5. Then, add the following Group names: Active, Inactive, Paying, Customers, Uninstalled, Trial Period. It should look something like this:
    MailChimp Recommended Groups
  6. Lastly, click Save.
  7. Repeat steps 3-6 for every different product that you sell through Freemius.

The Freemius-recommended MailChimp Rules

Login to your Freemius dashboard and go to INTEGRATIONS -> MAILCHIMP. Start creating the following rules:
1. Add email to My WordPress Shop/My Awesome Plugin/Active after install.installed or install.activated.
2. Add email to My WordPress Shop/My Awesome Plugin/Paying after payment.created.
3. Add email to My WordPress Shop/My Awesome Plugin/Customers after plan.lifetime.purchase, subscription.created, or license.extended.
4. Add email to My WordPress Shop/My Awesome Plugin/Trial Period after install.trial.started or install.trial.extended.
5. Add email to My WordPress Shop/My Awesome Plugin/Inactive after install.deactivated.
6. Add email to My WordPress Shop/My Awesome Plugin/Uninstalled after install.uninstalled.
7. Remove email from My WordPress Shop/My Awesome Plugin/Active after install.deactivated, install.uninstalled, or install.deleted.
8. Remove email from My WordPress Shop/My Awesome Plugin/Paying after license.expired or license.cancelled.
9. Remove email from My WordPress Shop/My Awesome Plugin/Trial Period after install.trial.cancelled or install.trial.expired.
10. Remove email from My WordPress Shop/My Awesome Plugin/Inactive after install.installed or install.activated.
11. Remove email from My WordPress Shop/My Awesome Plugin/Uninstalled after install.installed or install.activated.