Bulk sync lets you send all your existing WooCommerce customers to Mautic at once. This is useful when you first set up the plugin and want to populate Mautic with your full customer list, or when you need to re-sync everyone after changing field mappings or tags.
Which Users Are Included
Bulk sync includes all WordPress users with any of these roles:
- Customer
- Subscriber
- Administrator
- Shop Manager
Users without an email address are skipped automatically.
Step 1: Preview Your Data
Before starting the sync, you can preview exactly what data will be sent to Mautic.
- Go to WooCommerce > Mautic Integration and click the Contact Sync tab.
- Scroll down to the Bulk Sync section.
- Click the Preview Data button.
A modal window opens showing the first 10 contacts along with the total number of users that will be synced. Each row displays the field names and values that will be sent to Mautic. Use this preview to verify that the right fields are being mapped and that the data looks correct before committing to a full sync.
The preview note confirms that existing contacts in Mautic will be updated, not duplicated.
Step 2: Start the Sync
- Click the Start Bulk Sync button.
- A progress bar appears showing how many contacts have been processed out of the total.
- The Cancel button becomes visible in case you need to stop.
The sync processes contacts in small batches of 5 at a time. The page polls for progress updates automatically, and you will see the progress bar and counter update as each batch completes. Keep the browser tab open while the sync is running.
Cancelling a Sync
If you need to stop a sync that is in progress, click the Cancel button. The sync stops after the current batch finishes. Any contacts that were already synced remain in Mautic. You can start a new bulk sync at any time, and it will process all users from the beginning.
What Happens If Interrupted
If you close the browser tab, lose your internet connection, or navigate away from the page, the sync stops after the current batch. The sync state is stored as a WordPress transient that expires after one hour. If you return to the settings page while the transient is still active, the plugin will display the last known progress.
To start fresh after an interruption, simply click Start Bulk Sync again. This resets the counter and begins from the first user.
Error Handling
If a contact fails to sync (for example, due to a temporary API error), the error is logged and the sync continues with the next user. Up to 100 errors are stored in the sync state. You can review sync results in the Tools tab under the Sync Log section, where each successful and failed sync attempt is recorded with details.
Duplicates
You do not need to worry about creating duplicate contacts. The plugin uses Mautic’s Create or Update API endpoint, which matches contacts by email address. If a contact with the same email already exists in Mautic, it is updated with the latest data from WooCommerce.