Introduction to WooCommerce Subscriptions

WooCommerce Subscriptions is a premium extension that allows you to sell products and services with recurring payments. The content linked below aims to teach you how to use WooCommerce Subscriptions.

Requirements

↑ Back to top

In order to use WooCommerce Subscriptions, there are a few requirements:

Requirements
PHP version	7.0 or greater
MySQL version	5.6 or greater
WordPress version	5.9 or greater
WooCommerce version	6.5 or greater
Cron	Working WP Cron
Site URL	Live site served exclusively on one URL

For additional information, review WooCommerce requirements and server recommendations.

Compatibility

↑ Back to top

WooCommerce Subscriptions is compatible with High-Performance Order Storage (HPOS).
WooCommerce Subscription is compatible WordPress Multisite, but please keep in mind that each extension subscription will only be associated with the site on which it was purchased. User accounts (subscribers) created from using the extension will also only exist on the associated site. If you want to share a user account with other sites in your network, try the third-party Multisite User Management plugin.

↑ Back to top

Getting started

↑ Back to top

Subscriptions General Settings: Explains all the settings you’ll find in WooCommerce > Settings > Subscriptions.
Creating a Subscription Product: How to create a subscription product.
- How Subscriptions Manages Stock: A reference guide to how stock/inventory is reduced for subscriptions.
Guide to Synchronized Renewals: Reference guide for synchronized subscriptions and how they work.
- Creating a Synchronized Subscription Product: How to create a subscription product with synchronized renewals.
Understanding the Subscription Renewal Process: How the subscription renewal process works.
- Turning On/Off Automatic Renewals: How to turn on/off automatic renewals.
Subscriptions vs. Subscriptions Products: Understanding the difference between subscriptions (agreements) and subscription products.
Orders Related to Subscriptions: A guide to the different order types for WooCommerce Subscriptions.
Subscriptions Reports: A reference guide for the different reports available in this extension.
Migrating Subscribers to WooCommerce Subscriptions: A general guide to best practices for migrating subscribers to WooCommerce Subscriptions.
WooCommerce Subscriptions Snippets And Plugins: Additional snippets and mini plugins you can use to customize the appearance and functionality of WooCommerce Subscriptions.

Payments and payment gateway guides

↑ Back to top

Subscription Payment Gateway Guide: A guide to Subscriptions-compatible payment gateways.
- PayPal Standard (sunset) Guide and PayPal Reference Transactions for Subscriptions FAQ
Failed Recurring Payment Retry System: A reference guide to the automatic failed payment retry system in WooCommerce Subscriptions.
- Testing the Payment Retry System: How to test the automatic failed payment retry system.

Subscriptions management

↑ Back to top

Store Manager Settings: This section includes reference guides and instructions on how to manage subscriptions for store managers/admin.
- Manually Adding or Importing a New Subscription: How to add or import subscriptions to your store.
- Editing an Existing Subscription: How to edit existing subscriptions and process renewal payments through admin.
- Sort, Search, and Filter Subscriptions: How to find subscriptions quickly by using the sort, search, and filter actions in the WooCommerce > Subscriptions menu.
- Change a Subscription from Automatic to Manual Payments
- Subscription Status Guide: A reference guide to Subscription statuses.
- Subscriptions Resubscribe Guide: Guide to the subscription resubscribe process.
- Managing Expired Subscriptions
- Guide to Early Renewal Settings and Management
- Subscription Switching Guide: A guide to subscription switch settings, including understanding how the switching process works, how it handles price changes due to switches, how coupons are impacted, and how customers can change quantities of a subscription product as part of a switch.
- Guide to Subscription Emails

Subscriptions Coupons: There are two new coupon discount types introduced with WooCommerce Subscriptions: the recurring product discount and the signup fee discount. Recurring product discounts can be used to create limited subscription payment coupons that only apply to a predetermined amount of payments.

Subscriber’s View: This section outlines the different subscription management tools that your customers have access to in the Subscriptions section of their “My Account” page. It includes information about switching subscriptions, canceling/suspending subscriptions, resubscribing, managing payment methods, renewal payments, and accessing subscription information on the “View Subscriptions” page.
Restoring Subscriptions site from backup

Subscriptions testing and troubleshooting

↑ Back to top

Subscriptions use cases

↑ Back to top

Below you’ll find links to a few different use cases for WooCommerce Subscriptions. Some use cases only require WooCommerce Subscriptions, while others may implement other extensions. Requirements for each are explained at the beginning of each use case.

We have a range of extensions available from the WooCommerce.com Marketplace to help expand the capability of WooCommerce Subscriptions, including adding a subscription option to existing products, updating prices for existing subscribers, minimum periods, and more.

WooCommerce Subscriptions extensions in our Marketplace

Subscriptions developer guides

↑ Back to top

The following is developer-level documentation and provides explanations of the data structures, filters, and functions for Subscriptions. An advanced understanding of PHP and WordPress development is required.

Please note that we are unable to provide support for any customizations made to the default functionality of Subscriptions under our Support Policy. If you need to further customize a snippet, or extend its functionality, we highly recommend Codeable.