In the same way that WooCommerce applies an order status to indicate the current state of an order during its life-cycle, WooCommerce Subscriptions applies a status to a subscription.
This guide details each status, explains when it is applied, and what it represents.
Pending Subscription Status
↑ Back to topWhen a subscription is first created, either by a customer purchasing a subscription product via checkout or a store owner manually adding a subscription, it will have the Pending status.
This status indicates that the system has created the subscription, but has not processed any payments on it.
Active Subscription Status
↑ Back to topAfter the initial subscription payment processes (if it requires payment), the subscription transitions to Active.
This status indicates the subscription will renew or expire at a given time in the future. When a subscription is Active, the user connected with it receives the default subscriber role and may gain special access through other extensions, like WooCommerce Memberships. When a subscription is activated, Subscriptions also calculates the next payment date if it’s not already set.
On-Hold Subscription Status
↑ Back to topA subscription displays as On-Hold when an associated order is awaiting payment, or when the store owner or customer manually suspends it.
A subscription can remain On-Hold indefinitely. If manually suspended, the subscription requires manual reactivation. If suspended while awaiting payment, it automatically reactivates once the payment processes.
When a subscription is On-Hold, WooCommerce assigns the user associated with it the default inactive role, and other extensions, like WooCommerce Memberships, may no longer grant them special access.
Pending-Cancellation Subscription Status
↑ Back to topWhen a customer manually cancels a subscription, its status typically does not immediately transition to Cancelled. If the subscription has a pre-paid term that has not yet been fulfilled, it’s assigned Pending-Cancellation.
During this time, the user associated with the subscription retains the subscriber role and may still receive special access from other extensions, such as WooCommerce Memberships.
When the pre-paid term ends, the subscription’s status transitions to Cancelled.
Cancelled Subscription Status
↑ Back to topSubscriptions that reach the end of their pre-paid term (if applicable) transition to Cancelled. Once cancelled the user associated with the subscriptions moves to the default inactive user role and other extensions, like WooCommerce Memberships, may no longer grant special access. Neither customers nor store managers can reactivate cancelled subscriptions. Instead, customers need to manually create a new subscription or repurchase the subscription product.
Expired Subscription Status
↑ Back to topWooCommerce assigns the Expired status when a subscription reaches its end date. This end date may come from the product’s defined subscription length or from manual settings on the subscription itself. When a subscription expires, the system assigns the default inactive role to the associated user. Additionally, other extensions like WooCommerce Memberships may revoke their special access.
You cannot reactivate subscriptions with the Expired status. Customers must manually create a new subscription or repurchase the subscription product to regain access.