Mautic Fields

The Abandoned Cart module uses three custom fields on Mautic contacts to store cart data, the recovery link, and the coupon code. These fields are created automatically when the Auto-create Fields setting is enabled (the default), or you can create them manually in Mautic.

mautic_woo_cart_data

Label: Abandoned Cart Data
Type: Text
Alias: mautic_woo_cart_data

This field contains a JSON string with the abandoned cart details. The JSON structure includes the cart total, currency, recovery URL, and an array of cart items with product names, IDs, prices, and quantities. Here is an example of the data stored in this field:

{
  "total": "89.97",
  "currency": "USD",
  "recovery_url": "https://yourstore.com/?mautic_woo_recover=abc123...",
  "items": [
    {
      "name": "Blue T-Shirt",
      "product_id": 42,
      "price": "29.99",
      "qty": 3
    }
  ]
}

You can use this field in Mautic email templates with the token {contactfield=mautic_woo_cart_data}. However, because the raw value is JSON, it is most useful for advanced setups where you parse the data in a custom Mautic template or landing page. For most recovery emails, the other two fields (recovery URL and coupon code) are more practical to use directly.

mautic_woo_recovery_url

Label: Cart Recovery URL
Type: URL
Alias: mautic_woo_recovery_url

This field contains the one-click recovery link for the customer’s abandoned cart. When the customer clicks this URL, their cart is restored and they are redirected to checkout. The URL looks like this:

https://yourstore.com/?mautic_woo_recover=a1b2c3d4e5f6...

Use this field in your Mautic email templates with the token:

{contactfield=mautic_woo_recovery_url}

This is the most important field for recovery emails. Place it as the href of a prominent button or call-to-action link in your email.

mautic_woo_coupon_code

Label: Recovery Coupon Code
Type: Text
Alias: mautic_woo_coupon_code

This field contains the unique WooCommerce coupon code generated for this abandoned cart. The coupon code follows the format MWOO-RECOVER-XXXXXX. This field is only populated when coupon generation is enabled in the plugin settings.

Use this field in your Mautic email templates with the token:

{contactfield=mautic_woo_coupon_code}

For example, you can include the code in your email body so the customer can manually enter it at checkout: “Your exclusive discount code is {contactfield=mautic_woo_coupon_code}.” If auto-apply is enabled, the coupon is also applied automatically when the customer clicks the recovery link.

Auto-create Fields Setting

The Auto-create Fields setting on the Abandoned Cart tab controls whether the plugin automatically creates these custom fields in Mautic during the first sync. It is enabled by default. When enabled, the plugin checks for each field and creates it if it does not already exist.

If you prefer to create the fields manually in Mautic, disable this setting and create the fields yourself with the exact aliases listed above. Go to Settings > Custom Fields in Mautic, click New, and create each field with the correct alias, label, and type.

Checking Field Status

You can verify whether the required fields exist in Mautic by going to the Mautic Fields tab in the plugin settings. This tab shows all custom fields the plugin uses across all modules and indicates whether each one exists in your Mautic instance. You can also use the Create Fields button on that tab to create any missing fields.

When Fields Are Cleared

When a customer completes their purchase and their cart is marked as recovered, the plugin clears the mautic_woo_cart_data and mautic_woo_recovery_url fields on the Mautic contact. This prevents stale data from appearing in future emails. The mautic_woo_coupon_code field remains on the contact record but the coupon itself is trashed in WooCommerce so it can no longer be used.