PHPackages                             oneup/contao-mailchimp - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Mail & Notifications](/categories/mail)
4. /
5. oneup/contao-mailchimp

ActiveContao-bundle[Mail & Notifications](/categories/mail)

oneup/contao-mailchimp
======================

This extension connects a Contao installation with MailChimp.

4.10.0(1y ago)715.8k↓35.7%2[4 issues](https://github.com/1up-lab/contao-mailchimp/issues)MITPHPPHP ^7.4 || ^8.0CI failing

Since Oct 19Pushed 1y ago3 watchersCompare

[ Source](https://github.com/1up-lab/contao-mailchimp)[ Packagist](https://packagist.org/packages/oneup/contao-mailchimp)[ Docs](https://1up.io)[ RSS](/packages/oneup-contao-mailchimp/feed)WikiDiscussions main Synced yesterday

READMEChangelogDependencies (8)Versions (49)Used By (0)

Contao Mailchimp Bundle
=======================

[](#contao-mailchimp-bundle)

This Contao bundle provides subscribe and unsubscribe forms for easy integration in Contao.

[![Author](https://camo.githubusercontent.com/a1ca831710cc70c5c356e8dbc27e1212ed4d41a3ad0c6d9f7afbb02d78250cf4/687474703a2f2f696d672e736869656c64732e696f2f62616467652f617574686f722d40317570676d62682d626c75652e7376673f7374796c653d666c61742d737175617265)](https://twitter.com/1upgmbh)[![Software License](https://camo.githubusercontent.com/30597ff9a350144f03bffdd9183e16468e0b3ca1193e1d08591d992622738d55/687474703a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE)[![Total Downloads](https://camo.githubusercontent.com/dcd607d2ea9e9b5ee384002a0d30cf1b4d1e859400b0febc4cc730854cb09296/687474703a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6f6e6575702f636f6e74616f2d6d61696c6368696d702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/oneup/contao-mailchimp)

\--

The fields that will be shown are managed through MailChimp's [`List fields and *|MERGE|* tags`](http://kb.mailchimp.com/lists/managing-subscribers/set-default-merge-values-for-a-list). You may also change the order of this fields: In MailChimp, go to Signup forms > General forms > Signup Form and rearrange the fields via drag'n'drop. You then have to import the new field order into Contao, by simply re-saving the MailChimp list in the back end.

How-to
------

[](#how-to)

Install using the command line `composer require oneup/contao-mailchimp` or by using the [Contao Manager](https://contao.org/de/download.html).

### Requires of oneup/contao-mailchimp (Composer resolves this automatically)

[](#requires-of-oneupcontao-mailchimp-composer-resolves-this-automatically)

- [codefog/contao-haste](https://github.com/codefog/contao-haste)
- [contao/core-bundle](https://github.com/contao/core-bundle)
- [oneup/mailchimp-api-v3](https://github.com/1up-lab/mailchimp-api-v3)
- [patchwork/utf8](https://github.com/tchwork/utf8)

After installing the Contao MailChimp bundle you have to build a connection to MailChimp.

Login into the Contao Backend and go to Content > MailChimp:

- Create a new List
- Enter a name for your list
- Enter your [MailChimp API Key](https://mailchimp.com/help/about-api-keys/#find+or+generate+your+api+key)
- Enter your subscriber [List ID](https://mailchimp.com/help/find-your-list-id/)

Create four pages under Layout > Site Structure:

- Subscribe to the newsletter
- Subscribe confirmation
- Unsubscribe from the newsletter
- Unsubscribe confirmation

Go to Layout > Themes > Modules:

- Add a module of the type **Subscribe form**
- Choose your MailChimp List
- Choose the redirection page after subscription (Page: Subscribe to the newsletter)
- Choose whether you will use double opt-in for subscription
- Choose whether you will use the HTML5-Placeholder in the form fields or not
- Choose whether you will have the Contao captcha field
- Add a module of the type **Unsubscribe form**
- Choose your MailChimp List
- Choose the redirection page after unsubscription (Unsubscribe from the newsletter)
- Choose whether you will use the HTML5-Placeholder in the form fields or not
- Choose whether you will have the Contao captcha field

Go to Content > Articles:

- Insert the module of the type **Subscribe form** on the page Subscribe to the newsletter
- Insert the module of the type **Unsubscribe form** on the page Unsubscribe from the newsletter

### Form Generator

[](#form-generator)

You can also use forms of the form generator to subscribe to Mailchimp lists.

- Go to the settings of the form.
- In the *Mailchimp* section **Enable Mailchimp**.
- Select a *Mailchimp list* to subscribe to.
- Optionally select interest groups that new subscriptions should be assigned to by default.
- Optionally enter the name of a field which controls whether the subscription should take place or not (e.g. the field name of a newsletter checkbox).
- Optionally enable Mailchimp's double opt-in feature.
- Define the merge tags to map the form's input to the mailchimp list's fields. *Note:* you always need an `EMAIL` merge tag.
- Define optional added member tags.

### Known limitations

[](#known-limitations)

- If the captcha option is activated and the same module is multiple times visible on the website, it won't work properly. E.g. if you have a subscription form in the footer and the same module somewhere in the content - it won't work. You'll have to have a different module for the footer then.

###  Health Score

42

—

FairBetter than 88% of packages

Maintenance22

Infrequent updates — may be unmaintained

Popularity31

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity81

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 78.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~72 days

Recently: every ~79 days

Total

46

Last Release

652d ago

Major Versions

2.2.0 → 3.0.02017-09-27

3.0.2 → 4.0.02017-11-13

3.1.0 → 4.2.02018-05-23

2.2.1 → 3.1.12018-05-28

3.1.1 → 4.3.02018-06-18

PHP version history (3 changes)0.1.0PHP >=5.5

4.0.0PHP >=7.1

4.6.0PHP ^7.4 || ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/87bf1d07a851471e5d0ba2052e6a7a78d6313378214087a2919ff9979656ad0b?d=identicon)[bytehead](/maintainers/bytehead)

---

Top Contributors

[![bytehead](https://avatars.githubusercontent.com/u/754921?v=4)](https://github.com/bytehead "bytehead (75 commits)")[![fritzmg](https://avatars.githubusercontent.com/u/4970961?v=4)](https://github.com/fritzmg "fritzmg (12 commits)")[![sheeep](https://avatars.githubusercontent.com/u/607530?v=4)](https://github.com/sheeep "sheeep (5 commits)")[![akroii](https://avatars.githubusercontent.com/u/8830861?v=4)](https://github.com/akroii "akroii (1 commits)")[![cwittstock](https://avatars.githubusercontent.com/u/34371923?v=4)](https://github.com/cwittstock "cwittstock (1 commits)")[![netzarbeiter](https://avatars.githubusercontent.com/u/1942550?v=4)](https://github.com/netzarbeiter "netzarbeiter (1 commits)")

---

Tags

contaocontao-mailchimpcontao-modulemailchimpemailcontaomailchimpmarketingservices

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/oneup-contao-mailchimp/health.svg)

```
[![Health](https://phpackages.com/badges/oneup-contao-mailchimp/health.svg)](https://phpackages.com/packages/oneup-contao-mailchimp)
```

###  Alternatives

[terminal42/notification_center

Notification Center extension for Contao Open Source CMS

80413.7k101](/packages/terminal42-notification-center)[codefog/contao-news_categories

News Categories bundle for Contao Open Source CMS

3189.0k6](/packages/codefog-contao-news-categories)[markocupic/calendar-event-booking-bundle

Contao Calendar Event Booking Bundle

135.2k1](/packages/markocupic-calendar-event-booking-bundle)[contao-community-alliance/dc-general

Universal data container for Contao

1680.8k91](/packages/contao-community-alliance-dc-general)[metamodels/core

MetaModels core

10156.4k67](/packages/metamodels-core)[terminal42/contao-node

Node bundle for Contao Open Source CMS

3177.0k6](/packages/terminal42-contao-node)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)