Email Triggers

Email Triggers let you send Mautic email templates automatically when a WooCommerce order reaches a specific status. This gives you full control over transactional and marketing emails through your Mautic instance instead of relying on the default WooCommerce emails.

Enabling Email Triggers

Email triggers are disabled by default. To turn them on:

1. Go to WooCommerce > Mautic Integration and click the Order Sync tab.
2. Scroll down to the Email Trigger (Optional) section.
3. Check Enable Email Trigger.
4. Click Save Changes.

Mapping Templates to Statuses

Once enabled, you can assign a Mautic email template ID to each WooCommerce order status. The available statuses are:

• Pending – Order received but not yet paid
• Processing – Payment received, order is being prepared
• On Hold – Awaiting payment confirmation
• Completed – Order fulfilled and complete
• Cancelled – Order cancelled by the customer or store owner
• Refunded – Order has been refunded
• Failed – Payment failed or was declined

Enter the numeric Mautic email template ID next to each status that should trigger an email. Leave the value at 0 to skip that status. You do not need to assign a template to every status.

Finding Template IDs in Mautic

To find the email template ID in Mautic:

1. Log in to your Mautic instance.
2. Go to Channels > Emails.
3. Click on the email template you want to use.
4. Look at the URL in your browser. The number at the end is the template ID. For example, if the URL is https://mautic.example.com/s/emails/view/12, the template ID is 12.

Make sure you create the email templates in Mautic first before entering their IDs in the plugin settings.

Template Tokens

When the plugin sends an email, it passes order and product data as tokens that you can use in your Mautic email templates. The available tokens are:

• {order_id} – The WooCommerce order number
• {order_status} – The current order status
• {order_total} – The order total
• {currency} – The order currency
• {payment_method} – The payment method name (e.g. Credit Card)
• {payment_method_title} – The full payment method title
• {order_parent_id} – The parent order ID (for refund orders)
• {product_id} – The first product ID in the order
• {product_name} – The first product name
• {product_sku} – The first product SKU
• {product_price} – The first product price
• {product_type} – The first product type

Place these tokens directly in your Mautic email template content. They will be replaced with the actual values when the email is sent.

Important Notes

• Email triggers only fire when the order sync runs. If “Send All Statuses” is off (the default), emails are only triggered on completed and refunded orders, even if you have template IDs set for other statuses.
• Product tokens reference the first product in the order. If you need details for all products, use the mautic_woo_order_data contact field in your Mautic campaign logic instead.
• The email is sent via the Mautic API, not through WordPress. This means it follows your Mautic email configuration, sender settings, and sending rules.