What we do
Tools
Industries
Department
How we workLet's talk →
Home/WooCommerce/WooCommerce Subscriptions
WooCommerce

WooCommerce Subscriptions: Setting Up a Subscription Product and What Happens at Renewal

WooCommerce doesn't sell subscriptions out of the box. The usual route is WooCommerce Subscriptions, a paid extension made by Woo. It adds subscription products, charges the saved payment method on each renewal, and moves each subscription through statuses as payments succeed or fail. What it doesn't decide is what the rest of your business does when that status changes.

Before you build anything

It's a paid extension, billed as an annual license from WooCommerce.com, with a 30-day money-back guarantee. Core WooCommerce stays free.

WooPayments won't do it alone any more. Its old built-in subscriptions feature has been removed, so recurring billing through WooPayments needs the extension too.

Automatic renewals depend on the gateway. WooPayments, Stripe, PayPal and more than 20 others support them. With any other gateway, renewals are manual: the customer gets an invoice to pay.

Set up a subscription product

  1. 1

    Install the extension and connect a gateway that renews automatically

    Install WooCommerce Subscriptions, then check your payment gateway is on its supported list for automatic payments before you take a single subscriber.

    Watch for: subscribers who signed up through a gateway without automatic renewals will be on manual renewal, which means paying an invoice each cycle.

  2. 2

    Create the product

    Products Add New Product data

    Choose Simple subscription, or Variable subscription for sizes or plans. Set the price and how often it bills, weekly, monthly or yearly, then the length, an optional sign-up fee and an optional free trial.

  3. 3

    Set the store-wide rules

    WooCommerce Settings Subscriptions

    This is where you allow plan switching and its proration, line renewals up to one billing day with synchronization, and decide what customers can do themselves from My Account, such as suspending or cancelling.

  4. 4

    Turn on payment recovery

    WooCommerce Settings Subscriptions Payment recovery

    Tick Enable automatic retry of failed recurring payments and save. It's off by default, which means a single declined card stops a renewal for good unless the customer acts.

What happens when a WooCommerce subscription payment fails

With payment recovery on and the default rules. The retries run over seven days.

Time since the declined charge The subscription The renewal order
At the decline On-hold Pending, waiting for the first retry
After 12 hours Still on-hold First retry. No email on this one
After another 12 hours, then 24, then 48 Still on-hold Retries two to four, with emails to the customer and to you on some of them
After another 72 hours Still on-hold Fifth and last retry. If it fails, the order is marked Failed and the renewal invoice email goes out, if enabled

Seven days of on-hold, and nothing outside WordPress knows

All of that happens inside WooCommerce. If the subscription pays for access somewhere else, such as a separate app, a client portal, a course platform or a CRM flag your team works from, that system has no idea the card failed. The customer keeps access through every retry, and often after the last one, until someone checks the subscriptions list by hand.

WooCommerce Subscriptions exposes subscriptions through its own REST endpoints and adds subscription topics to WooCommerce webhooks, so a status change can be sent out the moment it happens. n-frames builds the receiving side: on-hold pauses access, a successful retry restores it, a cancellation closes the account and tells the right person, all logged so a missed event gets caught.

WooCommerce Subscriptions or Memberships

Two separate Woo extensions that are often bought together.

Subscriptions

Handles the money

  • The billing schedule, renewal orders, saved-card charges and retries.
  • Trials, sign-up fees, plan switching and gift subscriptions.
  • Knows whether a customer is paid up. Doesn't decide what that unlocks.
Memberships

Handles the access

  • Restricts content, products or member pricing on your WordPress site.
  • Access can come from a one-off purchase or a subscription.
  • Works on the WooCommerce site only, not in an app or portal elsewhere.

Recurring charge only, such as a coffee box: Subscriptions alone. Gated content on the same site: both. Access in a separate system: Subscriptions plus a connection to that system.

What the extension leaves to you

Charges that depend on usage

How you'll know: Part of the bill depends on seats, orders or hours tracked in another system, and someone edits renewal amounts by hand.

Fix: Subscriptions charges a set recurring price. The usage figure has to be written into the subscription before each renewal runs, which is a small integration on its REST API.

Recurring revenue reporting

How you'll know: Finance asks for MRR and churn and gets an export and a spreadsheet.

Fix: The extension's Upcoming Recurring Revenue and Retention Rate reports sit on WooCommerce's older, deprecated Reports screen, and Woo calls the forecast a guide only. A real MRR and churn figure needs its own report built from subscription and renewal data.

Renewals landing in the books

How you'll know: Every renewal is an order, and the accounting side gets hundreds of small ones each month.

Fix: Post renewals in a way your bookkeeper can reconcile against payouts. Our QuickBooks and WooCommerce guide covers the mapping.

Questions people ask

Is WooCommerce Subscriptions free?

No. It's a paid extension from Woo, sold as an annual license through WooCommerce.com, separate from free core WooCommerce and from your payment gateway's fees on each charge.

Can I sell subscriptions with WooPayments without the extension?

Not any more. WooPayments used to include a basic subscriptions feature, but it has been removed, and Woo points existing users to WooCommerce Subscriptions, which has a migration tool.

What happens when a WooCommerce subscription payment fails?

The subscription goes on-hold. If you've turned on automatic retries under Payment recovery, WooCommerce Subscriptions retries five times over seven days by default. If the last retry fails, the renewal order is marked Failed and the customer can pay the renewal invoice. Nothing outside WooCommerce changes unless something is built to act on the status.

Can customers switch between subscription plans in WooCommerce?

Yes, if you allow switching in the Subscriptions settings. Customers can upgrade, downgrade or cross-grade from My Account, and the extension prorates the difference according to the rules you set, rather than starting a new subscription.

What's the difference between WooCommerce Subscriptions and Memberships?

Subscriptions handles the recurring charge: the billing schedule, renewal orders and payment retries. Memberships handles what a purchase grants on your site: content, products or member prices. They're separate extensions that work together.

Who can connect WooCommerce Subscriptions to an app or portal outside WordPress?

n-frames builds that connection. It listens for subscription changes from WooCommerce, updates access in the other system, and keeps a record so a status change that never arrived is spotted.

Let's talk

Tell us the one thing your team does manually that eats up time. We read every message and reply within a day.