WooCommerce Subscriptions Setup Guide (Step by Step)

WooCommerce subscriptions setup requires the WooCommerce Subscriptions extension ($239/year from WooCommerce.com), a payment gateway that supports recurring charges (Stripe recommended), and careful configuration of billing intervals, renewal logic, and failed payment recovery. Subscription stores fail silently when renewal payments break — customers churn without ever contacting support.

One-time purchase stores have one failure point: checkout. Subscription stores have recurring failure points: initial signup, first renewal, payment method expiry, card declines, and cancellation handling. Setup is half the work. The other half is dunning — what happens when payments fail.

Prerequisites

Before installing WooCommerce Subscriptions:

• WooCommerce core installed and configured
• Payment gateway with tokenization — Stripe, PayPal, or Square (Stripe is the most reliable for subscriptions)
• SSL certificate active on the entire site
• Action Scheduler functioning (WooCommerce → Status → Scheduled Actions — no stuck queues)
• Reliable hosting — shared hosting with cron disabled will miss renewal charges

Step 1: Install and activate

1. Purchase WooCommerce Subscriptions from WooCommerce.com
2. Download and install via Plugins → Add New → Upload
3. Activate and enter your license key
4. Verify "Subscriptions" appears under WooCommerce → Settings

Step 2: Configure global subscription settings

Navigate to WooCommerce → Settings → Subscriptions:

The failed payment retry settings are the most important configuration in the entire plugin. Without retries, a single expired card silently cancels a subscription.

Step 3: Create a subscription product

1. Products → Add New
2. Product data dropdown: Simple subscription (or Variable subscription for tiered plans)
3. Configure the subscription terms:

1. Set product description, image, and category
2. Publish

Variable subscriptions

For tiered plans (Basic/Pro/Enterprise):

1. Product data: Variable subscription
2. Create a "Plan" attribute with values: Basic, Pro, Enterprise
3. Generate variations
4. Set different subscription prices per variation

Step 4: Configure payment gateway for recurring charges

Stripe is the recommended gateway for subscriptions:

1. Install WooCommerce Stripe Payment Gateway
2. Connect your Stripe account
3. Enable "Saved Cards" / tokenization
4. Test with Stripe test mode cards:

– Success: `4242 4242 4242 4242`

– Decline: `4000 0000 0000 0002`

– Requires authentication: `4000 0025 0000 3155`

Verify that Stripe creates a Customer and Payment Method object for each subscription — not just a one-time charge.

See the full payment gateway integration guide for gateway-specific setup.

Step 5: Test the subscription lifecycle

Run through the entire lifecycle in test mode before going live:

1. Purchase — complete checkout with a test card
2. Confirm subscription created — WooCommerce → Subscriptions → verify status "Active"
3. Verify initial payment — Stripe dashboard shows charge
4. Simulate renewal — WooCommerce → Subscriptions → select subscription → "Process renewal" (or wait for scheduled renewal)
5. Simulate failed payment — use decline test card on renewal
6. Verify retry logic — confirm retry emails send and retry attempts occur
7. Test cancellation — customer cancels via My Account → Subscriptions
8. Test reactivation — if supported, reactivate a cancelled subscription

Do not skip step 4. Most subscription bugs appear at first renewal, not initial signup.

Step 6: Customer self-service

Enable customer subscription management:

• WooCommerce → Settings → Accounts → enable "Customers can manage subscriptions from My Account"
• Customers can view subscription status, update payment method, change address, and cancel
• Reducing support tickets for "how do I cancel" pays for itself immediately

Subscription-specific email configuration

WooCommerce Subscriptions adds email types beyond standard WooCommerce:

Customize these in WooCommerce → Settings → Emails. Default templates are functional but generic.

Common subscription setup mistakes

Subscription + other WooCommerce features

Subscriptions + coupons

Coupons can apply to initial subscription, renewals, or sign-up fees independently. Configure in the coupon's "Usage limits" and subscription-specific fields.

Subscriptions + B2B wholesale

Wholesale customers can have subscription-based pricing tiers. Requires coordination between Wholesale Suite/B2BKing and WooCommerce Subscriptions role settings.

Subscriptions + membership content

Combine with WooCommerce Memberships to gate content behind active subscriptions. Membership access should sync with subscription status — active, on-hold, cancelled.

What subscription setup costs

Development estimates exclude the plugin license and hosting. Full subscription store builds typically fall in the $6,000–$12,000+ range as part of a broader WooCommerce development project.

FAQs

Does WooCommerce Subscriptions work with any payment gateway?

No. The gateway must support tokenization (saved payment methods) and recurring charges. Stripe, PayPal, and Square work. Bank transfer and check do not support automatic renewals (manual renewal only).

What happens when a customer's card expires?

With retry logic enabled, WooCommerce Subscriptions attempts the renewal, fails, sends a "update your payment method" email, and retries over several days. Without retries, the subscription moves to "on-hold" and eventually "cancelled" — often without the customer noticing.

Can customers pause subscriptions?

Not natively. WooCommerce Subscriptions supports suspend/resume via admin or extensions. If pause is a business requirement, configure it during setup — not as an afterthought.

How do I handle subscription sales tax?

Tax applies to each renewal charge based on the customer's billing address at time of renewal. Configure tax rates in WooCommerce → Settings → Tax. For US sales tax, use TaxJar or Avalara integration for automated rate calculation.

Is WooCommerce Subscriptions the only option?

Alternatives include YITH WooCommerce Subscription (lower cost), SUMO Subscriptions, and Paid Memberships Pro (membership-focused). WooCommerce Subscriptions is the most maintained and compatible with the WooCommerce ecosystem. For most stores, it is worth the license cost.

Next step

If you are setting up subscriptions and want to avoid the renewal bugs that cost stores 10–20% of recurring revenue, start with a scoped review of your payment and retry configuration.

Book a free 15-minute WooCommerce audit →

For product type selection and payment gateway setup, see the related guides.