Automatic sync sends customer data to Mautic in real time whenever a user registers, is created as a customer, or updates their profile. This article explains what triggers the sync, what data is sent, and how to control which fields are included.
Sync Triggers
When the Sync on Registration option is checked (enabled by default), the plugin listens for three events:
- WooCommerce customer creation – A new customer account is created during checkout or by a store admin.
- WordPress user registration – A user registers through the My Account page, WordPress registration form, or any other registration method.
- Profile update – An existing user saves changes to their profile from the front end or the WordPress admin.
The plugin includes built-in duplicate prevention. If both the WooCommerce customer creation and WordPress user registration events fire for the same user (which can happen during checkout), the data is only sent to Mautic once.
Data Sent to Mautic
The following core fields are always included when available:
- First name (mapped to Mautic’s
firstnamefield) - Last name (mapped to Mautic’s
lastnamefield) - Email address (mapped to Mautic’s
emailfield)
The following fields are included based on your settings:
Billing Information
When Sync Billing Info is checked (enabled by default), the plugin sends these additional fields:
- Company (mapped to
company) - Address line 1 (mapped to
address1) - Address line 2 (mapped to
address2) - City (mapped to
city) - State (mapped to
state) - Country (mapped to
country) - Postcode / ZIP (mapped to
zipcode)
Country and state codes are automatically converted to their full names. For example, US becomes United States (US) and CA becomes California, so your Mautic contact records display readable location data.
Phone Number
When Sync Phone is checked (enabled by default), the billing phone number is sent to Mautic’s phone field.
Lifetime Value Fields
For customers with WooCommerce order history, the plugin also sends two lifetime value fields:
- Total spent (mapped to
mautic_woo_total_spent) - Order count (mapped to
mautic_woo_order_count)
These fields must exist in Mautic before data can be written to them. Use the Mautic Fields tab to check and create the required custom fields.
Custom Field
You can set a custom Mautic field on every synced contact. Enter the Custom Field Alias (the Mautic field alias, not the label) and the Custom Field Value you want applied. For example, you could set a field alias of lead_source with a value of woocommerce to identify contacts that came from your store.
Toggling Sync On and Off
To disable automatic sync without turning off the entire Contact Sync module, uncheck the Sync on Registration option and save. This stops the real-time hooks but keeps all other Contact Sync features (bulk sync, subscribe forms, consent settings) active.