MailerPress Integration
MailerPress is a self-hosted WordPress email marketing plugin. WP Smart Consent integrates with it via the add_mailerpress_contact() PHP function — no external API key or internet connection required. The integration runs entirely on your server.
Enabling the Integration#
In the WP Smart Consent dashboard, go to CRMs & ESPs, find the MailerPress card, open the Connection tab, and toggle it on. MailerPress must be installed and active on the same site.
Pro Custom Fields#
If you are running MailerPress Pro, the Pro custom fields tab lets you map WPSC data fields to MailerPress Pro contact custom field keys. Add a row, select the WPSC source field on the left, and enter the MailerPress Pro field key on the right. The field key must match exactly what is defined in MailerPress Pro → Contacts → Custom Fields. Keys are case-sensitive.
Custom field values are sent under the custom_fields key in the add_mailerpress_contact() payload as { field_key: field_value }, which MailerPress Pro writes to wp_mailerpress_contact_custom_fields.
Field Mapping#
MailerPress does not use a field mapping table. Email, first name, and last name are always forwarded automatically using the contactEmail, contactFirstName, and contactLastName keys. For additional fields beyond those, use the Pro custom fields tab.
How It Works#
WP Smart Consent calls add_mailerpress_contact() — a global helper function exposed by MailerPress in mailerpress/src/functions.php. The contact is created with contactStatus: subscribed and opt_in_source: wpsc_checkout so you can filter by origin inside MailerPress.
The full payload can be modified via the wpsc_mailerpress_contact_data filter before the call is made.
Custom Fields Tab#
The Custom fields tab for MailerPress shows a note directing you to the Pro custom fields tab for additional field mapping. Standard email, first name, and last name are handled automatically and do not need to be configured here.
Options#
The Options tab has two settings.
Update existing contacts — controls whether an existing MailerPress contact matched by email is updated on each opt-in.
Send on unchecked — when enabled, contacts are forwarded to MailerPress even when the opt-in checkbox was not ticked.
Troubleshooting#
Contact not appearing — confirm MailerPress is installed and active. WP Smart Consent checks for the add_mailerpress_contact function at opt-in time and silently skips the call if it is not available.
Pro custom field values not saving — confirm the field key in the Pro custom fields tab exactly matches the key defined in MailerPress Pro → Contacts → Custom Fields. Keys are case-sensitive. Also confirm MailerPress Pro is active — the standard free version does not support custom contact fields.
No Pro custom fields tab visible — the Pro custom fields tab always appears in the WP Smart Consent UI regardless of whether MailerPress Pro is installed. The tab is visible but the data will only be written if MailerPress Pro’s custom fields table is present.