The plugin uses 6 custom contact fields in Mautic. These fields must exist in your Mautic instance for Order Sync, Abandoned Cart, and lifetime value tracking to work properly.
Field Reference
Below is the full list of custom fields, their Mautic aliases, types, and what each one stores.
mautic_woo_order_data
- Label: Last Order Data
- Type: Text
- Used by: Order Sync
- Description: Stores a JSON string containing the most recent order details, including line items, totals, coupons used, discount total, currency, and payment method. This field is overwritten each time a new order syncs.
mautic_woo_cart_data
- Label: Abandoned Cart Data
- Type: Text
- Used by: Abandoned Cart
- Description: Stores a JSON string containing the abandoned cart contents, including product names, quantities, prices, cart total, and currency. You can use this data in Mautic email templates to show the customer what they left behind.
mautic_woo_recovery_url
- Label: Cart Recovery URL
- Type: URL
- Used by: Abandoned Cart
- Description: A unique one-click recovery link that restores the customer’s cart when visited. Include this URL in your Mautic abandoned cart emails so customers can return to checkout with a single click.
mautic_woo_total_spent
- Label: Total Spent
- Type: Number
- Used by: Order Sync
- Description: A running total of the customer’s lifetime spend across all completed orders. This value is updated each time an order syncs and can be used in Mautic segments to create groups like “high-value customers” or “VIP buyers.”
mautic_woo_order_count
- Label: Order Count
- Type: Number
- Used by: Order Sync
- Description: A running total of the number of orders the customer has placed. This value increases with each synced order and is useful for segmenting repeat buyers from first-time customers.
mautic_woo_coupon_code
- Label: Recovery Coupon Code
- Type: Text
- Used by: Abandoned Cart
- Description: An auto-generated WooCommerce coupon code created for abandoned cart recovery. When coupon generation is enabled, the plugin creates a unique discount code for each abandoned cart and stores it here. You can include this code in your Mautic recovery emails to offer the customer a discount incentive.
Using Fields in Mautic
Once these fields exist in your Mautic instance, you can use them in email templates, segments, campaigns, and reports. For example, you can insert the {contactfield=mautic_woo_recovery_url} token into an email to display the recovery link, or build a segment that filters contacts where mautic_woo_total_spent is greater than 100.
If any of these fields are missing, the plugin will not be able to write data to them during sync. See the next pages for how to check and create fields.