PHPackages                             boundstate/craft-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. boundstate/craft-mailchimp

ActiveCraft-plugin[Mail & Notifications](/categories/mail)

boundstate/craft-mailchimp
==========================

Subscribe users to Mailchimp lists in Craft CMS

v4.0.0(3y ago)0257[13 PRs](https://github.com/boundstate/craft-mailchimp/pulls)MITPHPPHP ^8.0.2

Since Jan 9Pushed 2y ago2 watchersCompare

[ Source](https://github.com/boundstate/craft-mailchimp)[ Packagist](https://packagist.org/packages/boundstate/craft-mailchimp)[ RSS](/packages/boundstate-craft-mailchimp/feed)WikiDiscussions craft-4 Synced 6d ago

READMEChangelog (3)Dependencies (3)Versions (20)Used By (0)

Mailchimp plugin for Craft CMS 4.x
==================================

[](#mailchimp-plugin-for-craft-cms-4x)

Subscribe users to Mailchimp lists in Craft CMS

Installation
------------

[](#installation)

To install the plugin, follow these instructions.

1. Open your terminal and go to your Craft project:

    ```
     cd /path/to/project

    ```
2. Then tell Composer to load the plugin:

    ```
     composer require boundstate/craft-mailchimp

    ```
3. In the Control Panel, go to Settings → Plugins and click the “Install” button for Mailchimp.
4. In the Control Panel, go to Settings → Plugins → Mailchimp and configure the plugin.

Usage
-----

[](#usage)

Your subscribe form template can look something like this:

```

    {{ csrfInput() }}

    {{ redirectInput('subscribe/thanks') }}

    Your Name

    Your Email

    {{ subscription.getErrors('email')|join() }}

```

The only required field is `email`. Everything else is optional.

### Redirecting after submit

[](#redirecting-after-submit)

If you have a `redirect` hidden input, the user will get redirected to it upon successfully subscribing. The following variables can be used within the URL/path you set:

- `{email}`
- `{mergeFields}`
- `{tags}`

For example, if you wanted to redirect to a `subscribe/thanks` page and pass the user’s name to it, you could set the input like this:

```
{{ redirectInput('subscribe/thanks?name={mergeFields.NAME}') }}
```

In your `subscribe/thanks` template, you can access URL parameters using `craft.app.request.getQueryParam()`:

```
Thanks for subscribing, {{ craft.app.request.getQueryParam('name') }}!
```

Note that if you don’t include a `redirect` input, the current page will get reloaded.

### Flash messages & API errors

[](#flash-messages--api-errors)

When a subscribe form is submitted, the plugin will set a `notice` or `success` flash message on the user session. You can display it in your template like this:

```
{% if craft.app.session.hasFlash('notice') %}
    {{ craft.app.session.getFlash('notice') }}
{% elseif craft.app.session.hasFlash('error') %}
    {{ craft.app.session.getFlash('error') }}
{% endif %}
```

If the Mailchimp API returns an error, the plugin also sets the `subscription.apiError` variable. You can display it in your template like this:

```
{% if subscription is defined and subscription.apiError %}
    {{ subscription.apiError.title }}
    {{ subscription.apiError.detail }}
{% endif %}
```

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity70

Established project with proven stability

 Bus Factor1

Top contributor holds 100% 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 ~234 days

Total

5

Last Release

1384d ago

Major Versions

v1.1.1 → v4.0.02022-08-03

### Community

Maintainers

![](https://www.gravatar.com/avatar/2c8f627574f6bee1e622a2c9ada35d4347e67f6c92377bb80045c7c6661f390c?d=identicon)[mikejpeters](/maintainers/mikejpeters)

---

Top Contributors

[![mikejpeters](https://avatars.githubusercontent.com/u/3334654?v=4)](https://github.com/mikejpeters "mikejpeters (12 commits)")

---

Tags

cmsmailchimpCraftcraftcmscraft-plugin

### Embed Badge

![Health badge](/badges/boundstate-craft-mailchimp/health.svg)

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

###  Alternatives

[craftpulse/craft-notifications

Send notifications across a variety of delivery channels, including mail and Slack. Notifications may also be stored in a database so they may be displayed in your web interface.

551.2k](/packages/craftpulse-craft-notifications)

PHPackages © 2026

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