Mail Chimp integration for your Spree store
Ruby HTML JavaScript CSS
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Spree + Mail Chimp

MailChimp API integration for your Spree store, using the hominid gem.

Adds a checkbox to the user signup form to allow customer to opt-in to your Mailchimp mailing list. Mailchimp API calls happen via the hominid gem.

Mailchimp subscription status is tracked with a boolean flag on the users table, we also fetch and store the unique MC record id when the subscription is created. This allows us to modify existing email addresses with minimal fuss.

This is a very simple extension as of now, any ideas suggestions or improvements welcome!

Subscription form partial with JS

Also includes a partial at shared/newsletter_subscribe_form that can be included in your footer or sidebar anywhere on the site, has one field for the email address. jQuery code in public/javascripts/mailchimp_subscribe.js will POST to the SubscriptionsController which will relay to Mailchimp.

The SimpleModal plugin is used in the EJB to pop up a confirmation or error alert (because you won’t be satisfied with a simple alert() box)


Add to project’s Gemfile:

gem 'spree_mail_chimp'

Run from project’s root:

bundle install

rails g spree_mail_chimp:install


See the Mail Chimp Settings forms in the Admin under Configuration.

Note, using Mail Chimp “Merge Vars”, you can have any callable methods on User sent
to the MC list, mapped to indentically named (but uppercased) fields in the MC list admin console.
Unfortunately these are only sent at the time the subscription is created, so there isn’t much available.

As well you need the fields again lowercased with _changed? functions if you want them to update in mailchimp when you update them.


Version 3.0.0 – released 19 Apr 2012 – Spree 1.0 compat
Version 2.0.0 – released 6 Dec 2010 – Spree 0.30-stable
Version 1.0.1 – released 21 Nov 2010 – Spree 0.11-stable


Spree >= 1.0
hominid >= 2.2.0

Also uses the jQuery SimpleModal plugin, included.


Authored by Sam Beam @sbeam
Migrated to Spree 0.30 by Bastian Schnurle @bzt
Migrated to Spree 1.0 (and extensively refactored) by James Kong @jkongie

Inspired originally by

includes SimpleModal


  • make subscribe_to_newsletter_field work
  • Send user address info to MC via merge vars, when address is given
  • Export new orders to Mailchimp for full CRM gnarliness
  • Utility to export existing users to Mailchimp
  • Add admin controller to view lists and subscriptions
  • Allow for multiple lists
  • Tests :/