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.2.6.tar.gz (14.2 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.2.6-py3-none-any.whl (17.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: pretix_mailchimp-0.2.6.tar.gz
  • Upload date:
  • Size: 14.2 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.2.6.tar.gz
Algorithm Hash digest
SHA256 51c5ba65a8f627134c10d7e7f7119f3313e5c39a629fb2e7d960a6e3003253c8
MD5 52fd4e6301d219e6286d12ef8454c265
BLAKE2b-256 700f5344eba0cf94ba6eddf7e9ab873e70f9f3fa2a0baf6e2883d90e2ee7f6c1

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pretix_mailchimp-0.2.6-py3-none-any.whl
Algorithm Hash digest
SHA256 2783719cdfe007383b38abc728d8bfafb7828872e3baf8781ec07f4bd50cd3c7
MD5 a140b77ea23629cf11b4e5d97399b35a
BLAKE2b-256 ee601f1db04cceb413622772ca4d8b787e1cad2a643e1b5295de735edf768e49

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