Simple MailChimp integration with Sylius eCommerce framework.
Switch branches/tags
Nothing to show
Clone or download
Latest commit bb2b292 May 28, 2018



This plugin allows you to integrate MailChimp newsletter sign-in process with Sylius platform through customer registration, account updates or footer/modal join newsletter form.


We work on amazing eCommerce projects on top of Sylius and Pimcore. Need some help or additional resources for a project? Write us an email on or visit our website! 🚀


We created a demo app with some useful use-cases of the plugin! Visit to take a look at it. The admin can be accessed under link and sylius: sylius credentials.


$ composer require bitbag/mailchimp-plugin

Import routing in your routing.yml file:

    resource: "@BitBagSyliusMailChimpPlugin/Resources/config/routing.yml"
    prefix: /

Add plugin dependencies to your AppKernel.php

public function registerBundles()
    return array_merge(parent::registerBundles(), [
        new \BitBag\SyliusMailChimpPlugin\BitBagSyliusMailChimpPlugin(),


Add MailChimp API key and default list ID to your parameters.yml file

    mailchimp.api_key: YOUR_API_KEY
    mailchimp.list_id: DEFAULT_LIST_ID

In your twig template include

{% include '@BitBagSyliusMailChimpPlugin/_subscribe.html.twig' %}

In case you'd like to submit the form with AJAX

  1. Install assets
$ bin/console assets:install --symlink
  1. Override default sylius javascript template
<script src="{{ asset(path) }}"></script>
<script src="{{ asset('bundles/bitbagsyliusmailchimpplugin/bitbag-mailchimp-plugin-newsletter.js') }}"></script>

That's the simplest and fastest way to integrate the jQuery plugin. If you need to customize it, simply take a look at
bitbag-mailchimp-plugin-newsletter.js, create your own *.js plugin and import it in your main Gulpfile.js.


In order to run tests, execute following commands:

$ composer install
$ cd tests/Application
$ yarn install
$ yarn run gulp
$ bin/console doctrine:database:create --env test
$ bin/console doctrine:schema:create --env test
$ vendor/bin/behat
$ vendor/bin/phpunit
$ vendor/bin/phpspec


Learn more about our contribution workflow on