Debug Mode enables detailed logging of all plugin activity, including API requests, responses, and internal processing steps. This is useful for troubleshooting connection issues, sync problems, or unexpected behavior.
How to Enable Debug Mode
- Go to WooCommerce > Mautic Integration and open the Connection tab.
- Scroll down to the Logging section at the bottom of the page.
- Check the box labeled Enable debug logging.
- Click Save Changes.
Normal Mode vs Debug Mode
The plugin uses different logging levels depending on whether Debug Mode is enabled:
- Normal mode (Debug Mode off): Only warnings and errors are logged. This includes authentication failures, API errors, and other problems that need attention. This is the recommended setting for production stores.
- Debug mode (Debug Mode on): All log levels are recorded, including detailed debug messages. This includes every API request URL and method, token refresh attempts, sync operations, and other processing details.
Where to Find the Logs
The plugin writes its logs through the WooCommerce logging system. To view the logs:
- In WordPress, go to WooCommerce > Status.
- Click the Logs tab.
- In the log file dropdown, look for files with the source name mautic-integration-woocommerce.
- Select a log file and click View to see its contents.
Log files are named with the source and date, so you may see multiple files if the plugin has been logging over several days.
What Gets Logged
In Normal Mode
- API errors (failed requests, HTTP error codes)
- Authentication failures
- Token refresh failures
- Warnings about data issues (for example, invalid email addresses or rejected field values)
In Debug Mode (all of the above, plus)
- Every API request with the HTTP method and URL
- Contact sync operations
- Order sync processing
- Abandoned cart detection and recovery events
- Token refresh attempts
Performance Note
Debug Mode writes significantly more data to the log files. On a busy store, this can generate large log files and add a small amount of overhead to each operation. For this reason, you should only enable Debug Mode when you are actively troubleshooting an issue. Once the issue is resolved, turn Debug Mode off to keep your store running at peak performance.
Fallback Logging
If the WooCommerce logging system is unavailable for any reason, the plugin falls back to writing entries to the PHP error log. You can find these entries in your server’s error log file, which is typically located at a path like /var/log/php-errors.log or as configured by your hosting provider.
Log Levels Reference
The plugin uses the following log levels, listed from most to least verbose:
- Debug – Detailed diagnostic information (only logged in Debug Mode)
- Info – General operational messages (only logged in Debug Mode)
- Notice – Normal but noteworthy events (only logged in Debug Mode)
- Warning – Something unexpected happened but the operation continued
- Error – An operation failed
- Critical – A serious failure that needs immediate attention
- Alert – Action must be taken immediately
- Emergency – The system is unusable
In normal mode, only levels 4 through 8 (Warning and above) are recorded. In Debug Mode, all 8 levels are recorded.