Cherry Seed

Why does WooCommerce disable webhooks after five delivery failures?

webhook woocommerce delivery-failure server-side event-tracking retry

Quick Answer

WooCommerce disables any webhook after 5 consecutive delivery failures with no alert to the store owner, silently dropping all subsequent events until the webhook is manually re-enabled. There's no built-in retry-with-backoff, no dead-letter queue, and no notification system — the feature simply goes quiet. For stores relying on webhooks for inventory sync, fulfilment triggers, or server-side event delivery to ad platforms, this creates a compounding data gap that grows until someone manually checks webhook status in the WordPress admin.

Full Answer

The 5-failure threshold is hard-coded in WooCommerce core — it isn't a configurable setting. When a webhook endpoint returns a non-2xx HTTP status or times out on 5 consecutive attempts, WooCommerce sets the webhook's status to "disabled" in the database and stops all delivery. No event is queued for later. No log entry alerts the admin. The events that should have fired are simply gone.

This design made sense when webhooks were used for low-stakes notifications, but it becomes a serious liability when webhooks carry conversion events to analytics or ad platforms. A temporary server outage, a firewall rule change, or an expired SSL certificate on the receiving end can trigger 5 failures in minutes — and then every purchase, refund, and order status change after that point disappears from the downstream system without any warning.

The practical fix is an intermediary delivery layer — a webhook proxy like Hookdeck or a managed server-side tracking pipeline that doesn't depend on WooCommerce's native webhook delivery mechanism at all. These tools add automatic retry logic with exponential backoff, failure alerting, and event persistence that WooCommerce doesn't provide out of the box. How many developer hours does GTM server-side setup actually require? covers the infrastructure cost of building this kind of event resilience from scratch.

Sources

Programmatic Access

GET https://seresa.io/wp-json/cherry-tree-by-seresa/v1/seeds/1072

Cite This Answer

Cherry Tree by Seresa - https://seresa.io/seed/server-side-tracking/woocommerce-webhook-five-failure-disable