How to Connect Mautic to WooCommerce (Step-by-Step Guide)

Why Connect Mautic to WooCommerce?

If you’re running a WooCommerce store and using Mautic for marketing automation, keeping the two in sync manually is a time drain. Every new customer, every order status change, every abandoned cart – that’s data sitting in WooCommerce that your Mautic campaigns can’t act on.

Connecting Mautic to WooCommerce lets you:

• Automatically create Mautic contacts when customers register or place orders
• Push order data to Mautic so you can segment customers by what they buy, how much they spend, and how often they purchase
• Trigger targeted emails based on order status changes – think shipping confirmations, review requests, or win-back campaigns
• Track abandoned carts and recover lost revenue with automated recovery emails
• Keep customer data current – billing address, phone number, lifetime value – without lifting a finger

The best part? Since Mautic is self-hosted, you’re not paying monthly fees to a SaaS email platform for every contact in your list. You own your data and your automation infrastructure.

In this guide, we’ll walk through the complete setup using the Mautic Integration for WooCommerce plugin – from installation to your first synced contact.

What You Need Before Starting

Before you begin, make sure you have the following ready:

1. A running Mautic instance – self-hosted on your own server (Mautic 4.x or 5.x). You’ll need the URL (e.g., https://mautic.yourdomain.com).
2. API access enabled in Mautic – Go to Mautic Settings > Configuration > API Settings and make sure the API is enabled. If you plan to use Basic Authentication, enable that option as well.
3. A WooCommerce store – WordPress 5.6+ with WooCommerce 5.0+ installed and active.
4. The Mautic Integration for WooCommerce plugin – You can purchase and download it here.

The plugin supports two authentication methods: Basic Auth (username and password) and OAuth2 (client ID and secret with authorization code flow). Basic Auth is simpler to set up, so we’ll use that in this guide. OAuth2 is recommended for production environments where tighter security is needed.

Step 1: Install and Activate the Plugin

After purchasing your license, download the plugin zip file from your account dashboard. Then:

1. In your WordPress admin, go to Plugins > Add New > Upload Plugin.
2. Choose the downloaded zip file and click Install Now.
3. Click Activate.
4. You’ll be prompted to activate your license. Enter your license key and click Agree & Activate License.

Once activated, you’ll find two new menus: a top-level Mautic WooCommerce dashboard and a Mautic submenu under WooCommerce for settings.

Step 2: Connect to Your Mautic Instance

Navigate to WooCommerce > Mautic in your WordPress admin. You’ll land on the Connection tab.

1. Mautic URL – Enter the full URL of your Mautic instance (e.g., https://mautic.yourdomain.com). No trailing slash.
2. Authentication Method – Select Basic Authentication.
3. Username – Your Mautic admin username.
4. Password – Your Mautic admin password. This is encrypted before being stored in the database.
5. Click Save Settings.

Now click the Test Connection button. If everything is configured correctly, you’ll see a green “Connected successfully!” message along with the number of contacts in your Mautic instance.

If the connection fails, double-check that your Mautic API is enabled, your credentials are correct, and your server can reach the Mautic URL. Enabling Debug Mode at the bottom of the Connection tab will log detailed API requests to WooCommerce > Status > Logs for troubleshooting.

Step 3: Configure Contact Sync

Click the Contact Sync tab and enable the module by checking Enable Contact Sync Module.

Here’s what each option does:

• Sync on Registration – Automatically pushes new customers and users to Mautic as soon as they register, create an account, or update their profile. Leave this enabled for most stores.
• Sync Billing Info – Includes billing address fields (street, city, state, zip, country) in the Mautic contact record. Useful for geo-based segmentation.
• Sync Phone – Includes the billing phone number.
• Default Tags – Comma-separated tags applied to every synced contact (e.g., woocommerce, customer). Great for distinguishing WooCommerce contacts from other sources in Mautic.
• Registration Consent – Optionally shows a marketing consent checkbox on registration forms. When enabled, only users who opt-in are synced to Mautic.

Click Save Settings when you’re done.

Bulk Sync Existing Customers

If you already have customers in WooCommerce, you don’t have to wait for them to re-register. The Bulk Sync section at the bottom of the Contact Sync tab lets you push all existing users to Mautic in one go.

Click Preview Data first to see a sample of what will be sent. When you’re ready, click Start Bulk Sync. The plugin processes users in batches of 50 via WP-Cron, so it won’t overload your server. A progress bar shows you how far along the sync is.

Step 4: Set Up Order Sync

Click the Order Sync tab. This module is enabled by default.

When a WooCommerce order changes status, the plugin sends the order data to Mautic as a JSON payload stored in a custom contact field. This includes item names, SKUs, prices, quantities, coupons, discount totals, and payment method.

Key settings to configure:

• Send All Statuses – By default, data is only sent on “completed” and “refunded” orders. Enable this to sync on every status change (pending, processing, on-hold, etc.).
• Auto-create Fields – When enabled, the plugin automatically creates the mautic_woo_order_data custom field in Mautic on first sync. Saves you a manual step.
• Tags – Adds product-based tags to contacts (e.g., blue-tshirt_completed). You can also enable category tags and general tags for broader segmentation.
• Notes – Optionally adds a detailed order note to the Mautic contact record.

The plugin also tracks customer lifetime value automatically. Two custom fields, mautic_woo_total_spent and mautic_woo_order_count, are updated on every order sync, giving you powerful data for segmentation and lead scoring in Mautic.

Step 5: Verify Everything Works

With both modules configured, it’s time to verify the integration is working:

1. Check Mautic Fields – Go to the Mautic Fields tab and click Check Fields. You should see green checkmarks next to each required field. If any are missing, click Create Missing Fields.
2. Create a test customer – Register a new account on your WooCommerce store. Within seconds, check Mautic. You should see a new contact with the customer’s name, email, and any billing details.
3. Place a test order – Complete a test purchase and check the Mautic contact for updated tags, order data, and lifetime value fields.
4. Check the Sync Log – Go to the Tools tab and click View Sync Log. Every sync action is logged here with timestamps, status, and details, making it easy to confirm everything is flowing correctly.

What to Set Up Next

With contacts and orders syncing, you’ve got the foundation in place. Here’s what you can do next to get even more out of the integration:

• Abandoned Cart Recovery – Enable the Abandoned Cart module to capture carts at checkout and trigger Mautic recovery campaigns with one-click cart restore links and auto-generated discount coupons.
• Email Triggers – Map each WooCommerce order status to a Mautic email template. Send a thank-you email on completed orders, a payment retry prompt on failed orders, or a win-back campaign on cancellations.
• Subscribe Forms – Use the [mautic_woo_subscribe] shortcode to add email capture forms anywhere on your site, or add data-mautic-woo to existing forms for silent email capture.
• Build Mautic Segments – Now that customer data is flowing into Mautic, create segments based on total spent, order count, product tags, or any other synced field. Use these segments to drive targeted campaigns.

Wrapping Up

Connecting Mautic to WooCommerce doesn’t have to be complicated. With the Mautic Integration for WooCommerce plugin, you can go from zero to fully synced in under 10 minutes. No custom code, no third-party middleware, no monthly SaaS fees.

Your WooCommerce customer data becomes available in Mautic for segmentation, lead scoring, and campaign automation. And because Mautic is self-hosted, you maintain full control over your marketing data and infrastructure.

Get the Mautic Integration for WooCommerce plugin and start automating your store’s marketing today.