Woocommerce Failure logs
The WooCommerce Failure Logs screen records what went wrong between the store and the ERP. When a product, category or order does not appear where it should, this is the screen that tells you why — and it is almost always the fastest route to the answer.
Documentation for WooCommerce Failure Logs
The logs help you monitor and troubleshoot integration issues, giving details of failed sync attempts and errors during data exchange.
Screen Breakdown
| Element | What it does |
|---|---|
| Search Log | Search by keyword or entity ID, WooCommerce or ERP. Enter a term and press Search. |
| Clear Logs | Removes old entries — see below. |
| Log Type | What kind of sync failed — product, category, order. |
| Woo Entity ID | The store record that triggered the error — a product, category or order ID. |
| ERP Entity ID | The corresponding ERP record, where one is linked. |
| Error Message | What caused the failure. Commonly an API connection failure, invalid credentials or mismatched data. |
| Created At | When it was logged, so you can trace the sequence. |
If there is nothing to show, the screen displays No records.
Clear Logs Feature
Clear Logs truncates every failure log and removes the historical record, freeing space and giving a clean slate.
Clearing is not selective and cannot be undone. Resolve the errors first — clearing a log full of unfixed failures hides the problem without solving it, and the same errors reappear on the next sync anyway.
Best Practices
- Check the log after any first-time sync, before assuming it worked.
- Work by error message rather than by row — one bad credential produces dozens of identical failures.
- Clear only once the underlying cause is fixed, so the next entries are genuinely new.
Additional Notes
Most failures fall into three groups: credentials, which point at Configurations; missing mappings, which point at Categories or SKUs; and data mismatches, where the store holds something the ERP will not accept.
Related pages
- Configurations — API keys and webhooks
- Woo Items — SKU matching
- Woo Categories — category mapping