Plugin - MailChimp (Create custom newsletter subscription forms)

RSForm!Pro - Mailchimp The RSForm!Pro - Mailchimp Plugin allows you to integrate your custom newsletter forms with the email-marketing manager.

With this integration you will be able to create subscription forms, pass users data to your Mailchimp account and assign them to the existing lists and groups.

Joomla! 3.0

Tutorial - Using RSForm!Pro together with MailChimp

The RSForm!Pro - MailChimp is a plugin that once installed and enabled will allow you to create custom subscription forms for the email-marketing manager. In this tutorial, you will learn how to install the plugin, then how to set up your MailChimp integration.

Technical requirements

In order to make the plugin work, you need:

  • Joomla! 3.x
  • Latest revision of RSForm! Pro
  • an active Mailchimp account

Getting the RSForm!Pro - MailChimp plugin

MailChimp with RSform!Pro

In order to download the RSForm!Pro - MailChimp Plugin you must have at least one active code of RSForm!Pro. Simply go to the My Downloads section of our website (You must be logged-in in order to see the My Downloads section).

In the list of downloads go to the RSForm!Pro section, and download the RSForm!Pro - MailChimp plugin.

Installing the plugin

Once you have downloaded the RSForm!Pro - MailChimp Plugin, you can install it using the default Joomla! installer as shown in the image below:

The RSForm!Pro MailChimp Plugin should auto-publish itself, but if that doesn't happen, you can go to Extensions / Plugin Manager and enable it. The plugin is located in the System group and you can identify it by the name of "System - RSForm! Pro MailChimp"

Enabling the integration

Once you have enabled the plugin, go to RSForm!Pro » Manage Forms and edit the form where you want to use the RSForm!Pro - MailChimp Plugin. You will notice that one more tab has appeared.

In order for the plugin to work you will have to enable it from Extensions > Plugin Manager, enter your MailChimp API key in Components > RSForm!Pro > Configuration > MailChimp and then set the plugin parameters.

After selecting your desired form, you will have to:

  • go to the MailChimp Integration tab and enable the integration for the form

  • select the action (subscribe/unsubscribe/let the user decide)

  • choose the list you will be working with (defined in your MailChimp account)

  • map the form components to your desired list fields for the "Merge Vars","Interest groups" sections.

Additional settings

The integration also offers the possibility to set up some additional parameters regarding the Subscribe and Unsubscribe processes:


  • Double Opt-In: No/Yes - Set to Yes in order to send a confirmation message when the user subscribes
  • Trigger tags automations: No/Yes - This option will let the tags automations to be trigger when the tag is added/updated. If any available.
  • Update if email already exists?: No/Yes - Set to Yes in order to have subscribers updated (if they already exist). Otherwise, an error will be thrown
  • Append Tags if email already exists: No/Yes - Activating this option will not update current tags for the existing email address, it will append the new ones to the old ones if they are different.
  • Replace Interests ?: No/Yes - Set to Yes in order to replace the existing interests with the provided ones. Otherwise, both the old and new interests will be kept


  • Delete Member ?: Set to Yes to have the member deleted when he unsubscribes
Interest Groups

Using the option from this section, you will be able to assign Interest groups to your subscribers.

The existing interest groups will be automatically retrieved from your Mailchimp account and listed below. In case you are creating a selection field, in order the user to select his interest group, you will have to use the exact values listed in this section.


You can add your desired tags or you can choose from the tags that you already defined. Please do not forget to separate them by comma if you want use multiple tags.

The existing tags will be automatically retrieved from your Mailchimp account and listed below.

Video tutorial:

Ep. 33 - Using RSForm!Pro with Mailchimp

09 Jun 2021
Version 3.0.0
  • Updated - Joomla! 4.0 and RSForm! Pro 3.0 compatibility.
07 May 2020
Version 1.52.0
  • Added - Tags support.
23 Jan 2020
Version 1.51.9
  • Fixed - Double Opt-in no longer required every time a subscriber is updated.
21 Mar 2019
Version 1.51.8
  • Updated - Code improvements.
  • Updated - Now showing possible values for multiple choice fields.
  • Fixed - Changing the list would not display the correct fields.
  • Fixed - Some fields were not mapped correctly.
25 Feb 2019
Version 1.51.7
  • Added - GDPR fields support.
  • Updated - Now mapping signup timestamp by default.
01 Feb 2019
Version 1.51.6
  • Fixed - Required fields were not marked.
10 Oct 2018
Version 1.51.5
  • Fixed - Replacing interests was not working correctly in some cases.
09 Oct 2018
Version 1.51.4
  • Updated - Dropped 'Use SSL' option since it's now mandatory for all connections.
  • Fixed - Empty values were not mapped.
21 May 2018
Version 1.51.3
  • Added - 'Maximum number of records to retrieve' option.
17 May 2018
Version 1.51.2
  • Added - 'Maximum number of lists to retrieve' option.
17 Mar 2016
Version 1.51.1
  • Added - API v3 support.
09 Oct 2015
Version 1.51.0
  • Added - Joomla! automatic updates support.
  • Updated - Bumped minimum requirements to use RSForm! Pro 1.51.0 and Joomla! 2.5.28
  • Updated - Some deprecated code has been removed.
16 Oct 2014
Version 1.50.1
  • Updated - Interests has been replaced with Groupings.
06 Oct 2014
Version 1.50.0
  • Updated - Deleting a form now correctly removes form's Mailchimp settings from the database.
  • Updated - Payment settings can be backed up and restored.
03 Sep 2014
Version 1.1.0
  • Fixed - Upload fields were not being mapped.
22 Nov 2013
Initial Release

25 persons found this article helpful.

Was this article helpful?

Yes No
Sorry about that

You Should Also Read

Plugin - Campaign Monitor (Create custom newsletter subscription forms) HOT

Plugin - Constant Contact (Create custom newsletter subscription forms) HOT

Plugin - VerticalResponse (Create custom newsletter subscription forms) HOT

Plugin - GetResponse (Create custom newsletter subscription forms) HOT

Plugin - dotmailer (Create custom newsletter subscription forms)