Chapter 05 · User guide

Subscriptions

When WooCommerce Subscriptions is installed the workspace gains a Subscriptions tab: schedules, renewal settings, statuses and related orders.

01 · When the tab appears

Only with WooCommerce Subscriptions

The Subscriptions entry in the top bar appears when the WooCommerce Subscriptions extension is installed and active. Stores without it simply do not see it. Subscriptions become searchable as soon as the first sync has finished.

02 · The subscription list

Status, next payment and total

The subscription list showing an active and several cancelled subscriptions.
The subscription list.
  1. Status tabs: All, Pending, Active, On hold, Pending cancellation, Cancelled, Expired and Trash.
  2. Search by subscription number, customer or email.
  3. Date filter.
  4. Subscription number and ID.
  5. Customer name and email.
  6. Status pill.
  7. Next payment date. Cancelled subscriptions show a dash.
  8. Recurring total.
  9. Create a subscription by hand.

03 · The subscription editor

Summary first, then the details

The subscription editor showing the summary, the billing address and the actions card.
An active subscription open in the editor.
  1. Jump to: Subscription summary, Billing schedule, Renewal settings, Related orders, Items, Totals, Payment, Order notes, Additional fields and Activity.
  2. Customer.
  3. Recurring total and the payment method on file.
  4. Next payment date, from the billing schedule.
  5. Status, changed here and saved.
  6. Process renewal: creates and charges the next renewal now.
  7. Create pending parent order for a subscription that has none.
  8. Move to Trash (recoverable).
  9. Billing and shipping address tabs.
  10. Save (⌘S).

Items, totals and payment work as on an order: lines can be added and removed and totals recalculated.

04 · Billing schedule

Interval, trial, next payment and end date

The Billing schedule card holds the billing interval and period, the start date, the trial end, the next payment date and the end date. Dates are validated against WooCommerce Subscriptions' rules before saving; if a combination is not allowed, FastOps says the schedule conflicts with those rules and nothing is saved.

05 · Renewal settings and actions

Automatic or manual renewal

Renewal settings holds the renewal mode: automatic renewals charge the saved payment method; manual renewals send the customer an order to pay.

Process renewal charges the customerThe action creates the next renewal order immediately and, for automatic renewals, charges it. Whether it is available follows the subscription status and the payment gateway.

06 · Statuses

Change the status from the editor

Change Status in the card on the right and Save. WooCommerce Subscriptions applies its own transitions, so moving to On hold or Cancelled behaves exactly as it does in wp-admin, including the emails it sends. Status changes for many subscriptions at once use Bulk update.

Close-up of subscription rows with active and cancelled statuses.
Active and cancelled subscriptions side by side.
  1. Active: renewals will run on the next payment date.
  2. Next payment for the active subscription.
  3. Cancelled: no further renewals.
  4. No next payment.