Skip to main content

Mailchimp newsletter subscription with booking (opt-in)

Project description

This is a plugin for pretix.

Mailchimp newsletter subscription with booking (opt-in).

Behavior

  • Activated on organizer level.

  • Applies to all events of the organizer by default.

  • Can only be disabled per event.

  • Shows an optional checkbox in the booking contact form.

  • Also shows an optional checkbox in the attendee/question form for every personalized order position, but only if the event asks for email addresses per ticket.

  • If no checkbox is selected, nothing is sent to Mailchimp.

  • If selected, the contact is created or updated in the configured Mailchimp audience.

  • The contact is tagged with the main pretix event, not the subevent/date.

  • Existing contacts are not overwritten unnecessarily; the event tag is added.

  • If booking contact and attendee use the same email address in one order, the plugin avoids duplicate Mailchimp calls.

Default public text:

ZAMgefasst, der Newsletter 1x pro Monat aus dem ZAM

Installation

Inside your pretix virtualenv:

pip install -e .

Then restart pretix and enable the plugin on organizer level.

Configuration

Go to the plugin settings on organizer level and configure:

  • Mailchimp API key

  • Mailchimp Audience/List ID

  • status for new contacts (pending recommended for double opt-in)

  • tag template

  • public checkbox label, with translations

  • public help text, with translations

Per event, go to event settings and use Newsletter opt-in deaktivieren if the opt-in should not be shown for that event.

Opt-in behavior

The plugin stores and evaluates two independent opt-ins:

  • booking contact opt-in: saved in order.meta_info["contact_form_data"]

  • attendee/position opt-in: saved in position.meta_info["question_form_data"]

This matters for events with non-personalized products: If pretix does not ask for attendee name/email per position, the booking contact can still explicitly subscribe.

Mailchimp tag template placeholders

The tag template can use:

  • {organizer} - organizer slug

  • {event_slug} - event slug

  • {event} - event name

  • {event_id} - internal event id

Example:

ZAM Veranstaltung: {event}

or more stable:

pretix:{organizer}:{event_slug}

Privacy note

This plugin only transfers a contact after explicit opt-in. For new Mailchimp contacts, pending is the recommended default so Mailchimp sends a confirmation email. Existing unsubscribed contacts are not forcefully resubscribed by default; they only receive the event tag.

Development setup

  1. Make sure that you have a working pretix development setup.

  2. Clone this repository.

  3. Activate the virtual environment you use for pretix development.

  4. Execute python setup.py develop within this directory to register this application with pretix’s plugin registry.

  5. Execute make within this directory to compile translations.

  6. Restart your local pretix server. You can now use the plugin from this repository for your events by enabling it in the ‘plugins’ tab in the settings.

This plugin has CI set up to enforce a few code style rules. To check locally, you need these packages installed:

pip install flake8 isort black

To check your plugin for rule violations, run:

black --check .
isort -c .
flake8 .

You can auto-fix some of these issues by running:

isort .
black .

To automatically check for these issues before you commit, you can run .install-hooks.

License

Copyright 2026 Julian Hammer

Released under the terms of the Apache License 2.0

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pretix_mailchimp-0.1.2.tar.gz (14.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pretix_mailchimp-0.1.2-py3-none-any.whl (17.2 kB view details)

Uploaded Python 3

File details

Details for the file pretix_mailchimp-0.1.2.tar.gz.

File metadata

  • Download URL: pretix_mailchimp-0.1.2.tar.gz
  • Upload date:
  • Size: 14.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.3

File hashes

Hashes for pretix_mailchimp-0.1.2.tar.gz
Algorithm Hash digest
SHA256 4786a4ab07326d419a31f118fd8051024a636719399fe9169d1c8e22c2070977
MD5 3145157fa6ff068adf3e02d1762b1880
BLAKE2b-256 e2ff27eeb4ce1d744ff43075eb6f6965ffe790726613bbfe9fe3ef1c43b64018

See more details on using hashes here.

File details

Details for the file pretix_mailchimp-0.1.2-py3-none-any.whl.

File metadata

File hashes

Hashes for pretix_mailchimp-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 d6f47717a7c886c3188f5eb72b31b39eb013d56e4c5618dc00b3279f56dbefd7
MD5 b0b59f9da119e3998e5f74e0701e244c
BLAKE2b-256 b9da476f8d2a7f340165c4e3af4314f6862020d894b47d89f3395fd1c9f8b006

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page