Product support

Visit this product's website for support.



In order to use the plugin you need to get the API key from your MailChimp account.

  1. In the OctoberCMS back-end go to the System / Settings page and click the MailChimp link.
  2. Paste the API key in the MailChimp API key field.

Creating the Signup form

You can put the MailChimp signup form on any front-end page. Add the MailChimp Signup Form component to a page or layout. Click the added component and paste your MailChimp list identifier in the MailChimp List ID field. Close the Inspector and save the page.

The simplest way to add the signup form is to use the component's default partial and the {% component %} tag. Add it to a page or layout where you want to display the form:

{% component 'mailSignup' %}

If the default partial is not suitable for your website, replace the component tag with custom code, for example:

    data-request-update="'mailSignup::result': '#subscribe-form'"
    <input type="text" name="email" placeholder="Newsletter subscription">
    <input type="submit" class="btn btn-default" value="Subscribe"/>

The example uses the standard partial mailSignup::result for displaying the subscription confirmation message. If you don't like the standard message you can create your own partial in your theme and specify its name in the data-request-update attribute. The default partial is located in plugins/rainlab/mailchimp/components/signup/result.htm.

  • Found the plugin useful on 3 Oct, 2019

    Worked for me. Thank-you.

  • Found the plugin useful on 4 Apr, 2018

    can anyone provide demo? cos plugin doesnt work for me.

    1. it installed 2, api key - ok entered
    2. component added to page -
    3. list code entered
    4. no change in form partitial using orig template

    and no subcribers , no popus about ok singed and etc

  • Found the plugin useful on 17 Feb, 2018

    It is a useful plugin. I would really appreciate it if there was a better explanation for the POST and DELETE methods. Thank you for your work.

  • Found the plugin not useful on 6 Dec, 2017

    Any way to get a bit more information regarding this plugin? For example: how to go further on Mailchimp or is it possible to add multiple form fields and pass that to Mailchimp?

    My main issue now is that I cannot send the information to Mailchimp. I inserted the API key, filled out the form, as written in the documentation. When looking into my newly created list, which I provided with the ListId, it seems to be empty.

  • Found the plugin useful on 26 Nov, 2017

    Very Useful. Keeps things simple. plus the partial extending is amazing

  • Found the plugin useful on 24 Oct, 2016

    Works very well... but why is there no "Configure Mailchimp API number" specific permission ?

    How can I make an admin group not able to change this API number ?

  • Found the plugin useful on 27 Sep, 2016

    Frithjof Gressmann it works in partials as well, you just have to add component to the layout and move the code to partial.

  • Found the plugin useful on 5 Jul, 2016

    Good one, however, it would be cool if signup form would work in partials as well.

  • Found the plugin useful on 21 Feb, 2016

    Good work

  • Found the plugin useful on 19 Jan, 2016

    Great plugin! Thanks for all the hard work.

  • Found the plugin useful on 28 May, 2015

    Works as expected!

  • Found the plugin useful on 2 Sep, 2014

    With few modifications this is a very useful plugin. Thanks.


Switch to MailChimp API v3

Aug 10, 2018


Improve compatibility with PHP7

Sep 07, 2017


Minor improvements to the code

Feb 13, 2015


Initialize plugin

May 12, 2014