What actually happens when a renewal payment fails
WooCommerce subscription grace periods: severity levels and day thresholds
A WooCommerce subscription renewal just failed. Nothing gets cancelled — WooCommerce Subscriptions opens a grace period instead: the subscription stays active, the customer keeps their access, and WooCommerce quietly retries the charge on its own schedule in the background. Nobody gets an email about it by default, and nothing on the order list makes it obvious how long that's been going on. (For how this compares to a failed payment or an expiring card, see the risk-types breakdown.)
Day zero: nothing looks different yet
When a renewal charge is declined, WooCommerce sets the subscription's grace flag and keeps it active — the customer isn't locked out, and the store isn't charging again immediately. The countdown starts from that moment. Subscription Health Check classifies the first two days as Info and sends no email at all, since most retry attempts succeed within this window and an alert this early would just be noise.
Escalation is by day count, not a calendar deadline
Once a subscription has been in grace for 3 days (the default — it's configurable), it moves to Warning. At 7 days (also configurable), it moves to Critical. These are thresholds, not fixed windows — a subscription that hits Critical on day 7 stays Critical on day 14, day 30, for as long as it remains unresolved. The severity only ever moves forward until something changes it.
Two ways it ends
Either the retry succeeds and the subscription returns to fully active — at which point it drops off the active-risk list on the next scan — or the customer cancels outright, which moves the subscription to a pending-cancel state. Pending-cancel subscriptions are deliberately excluded from grace alerts: the customer has already decided to leave, so a payment-recovery email at that point serves no one.
Why alerts don't pile up forever
A grace-period lookback window (6 months by default) keeps subscriptions that have been stuck in grace for an unusually long time from cluttering new alerts indefinitely. And within that window, the same subscription won't trigger the same email type twice inside a 35-day cooldown — so a Critical subscription that's been sitting there for three weeks doesn't generate a fresh email every single day it stays that way.
- ▸Warning threshold: 3 days in grace (default, configurable)
- ▸Critical threshold: 7 days in grace (default, configurable)
- ▸Grace lookback window: 6 months (default)
- ▸Pending-cancel subscriptions are excluded from grace alerts
- ▸Info tier (0–2 days): visible on the dashboard, no email sent
What is a WooCommerce Subscriptions grace period?
It's the window between a failed renewal payment and the subscription being cancelled, during which WooCommerce keeps the subscription active and automatically retries the charge on its own schedule.
How long does a WooCommerce subscription stay in grace period?
There's no fixed length — it lasts until the retry succeeds, the customer cancels, or it's manually resolved. Subscription Health Check escalates severity by day count (Warning at 3 days, Critical at 7, both configurable by default) rather than by a calendar deadline.
Does a customer lose access during a grace period?
No. WooCommerce keeps the subscription active and access intact while it's in grace — that's what distinguishes a grace period from a subscription that's already been cancelled.
See it flag your own subscriptions.
$129 per site, billed annually. Run the first scan on your own store's data, not a demo.
Buy now — $129/yr