Both the Order Sync and Abandoned Cart modules include an option to automatically create missing Mautic fields during the first sync. This is a convenience feature that removes the need to manually create fields before you start syncing data.
How It Works
When the auto-create fields setting is enabled on a module, the plugin checks whether the required custom fields exist in Mautic before sending data. If any fields are missing, the plugin creates them through the Mautic API automatically, then continues with the sync.
This check happens during the first sync operation after the plugin is configured. Once the fields exist, the plugin skips the creation step on future syncs and uses the cached field list instead.
Enabling Auto-Create Fields
Order Sync
Navigate to WooCommerce > Mautic Integration and open the Order Sync tab. Look for the Auto-create fields checkbox. This setting is off by default. Enable it if you want the plugin to create missing fields automatically when an order syncs for the first time.
Abandoned Cart
Navigate to WooCommerce > Mautic Integration and open the Abandoned Cart tab. Look for the Auto-create fields checkbox. This setting is on by default. When enabled, the plugin creates any missing fields the first time an abandoned cart is synced to Mautic.
When to Use This Setting
Auto-create fields is helpful when you are setting up the plugin for the first time and want to get started quickly without visiting the Mautic Fields tab. It is also useful if you are deploying the plugin on multiple stores and want the fields to be created automatically without manual steps.
If you prefer to control exactly when and how fields are created, leave this setting disabled and use the Check Fields and Create Missing Fields buttons on the Mautic Fields tab instead.
Important Notes
- Auto-create fields requires a working Mautic API connection. If your credentials are not configured or the connection is down, field creation will fail and the sync will log an error.
- The plugin caches the Mautic field list for 12 hours. After fields are created, the cache is cleared so the new fields are recognized immediately.
- Each module only creates the fields it needs. Order Sync creates the order data and lifetime value fields, while Abandoned Cart creates the cart data, recovery URL, and coupon code fields.