The Mautic Fields tab in the plugin settings lets you verify which custom fields exist in your Mautic instance and create any that are missing with a single click.
Opening the Mautic Fields Tab
Navigate to WooCommerce > Mautic Integration in your WordPress admin menu. Click the Mautic Fields tab at the top of the settings page.
You will see a table listing all 6 required custom fields with their alias, label, type, and a status column. The status column shows a dash until you run a check.
Checking Fields
Click the Check Fields button below the table. The plugin sends a request to your Mautic API to retrieve the list of existing contact fields. It then compares the results against the 6 required fields.
- A green checkmark means the field already exists in your Mautic instance and is ready to use.
- A red X means the field is missing and needs to be created before the related sync features will work.
You must have a working Mautic connection (configured on the Connection tab) for this check to work. If the check fails, verify your Mautic URL and credentials first.
Creating Missing Fields
After running a check, if any fields are missing, the Create Missing Fields button becomes active. Click it to have the plugin automatically create all missing fields in your Mautic instance through the API.
Each field is created with the correct alias, label, and type. When creation is complete, the plugin displays a message showing how many fields were verified or created. If any fields fail to create, the error message lists which aliases could not be created.
After Creating Fields
Once all 6 fields show a green checkmark, your Mautic instance is ready to receive order data, cart data, and lifetime value updates from the plugin. No further action is needed on this tab unless you delete fields from Mautic later.
The plugin caches the field list from Mautic for 12 hours to reduce API calls. If you create or delete fields directly in Mautic, you may need to wait for the cache to expire or click Check Fields again to refresh the status.