WooCommerce Subscriptions

Version 9.2.0 2026-09-08

• Update: We've redesigned the WooCommerce Subscriptions settings page — a single-column layout with clearer labels and inline help
• Early renewal payments are now on by default on stores that never saved the "Allow early renewal payments" setting. Turn it off under WooCommerce > Settings > Subscriptions.
• "Turn off automatic payments" now requires "Accept Manual Renewals" to be enabled.
• "Suspensions per Billing Period" is now a number field instead of a dropdown.
• "Switch Button Text" now defaults to "Switch" for new stores.
• Gifting is now set per product instead of storewide. A background migration carries the storewide default onto existing products, so they keep their current behavior; new products are off by default.
• A new bulk edit action on the Products screen enables or disables gifting across multiple products at once.
• Update: When a subscription's scheduled event - a renewal payment, payment retry, trial end, expiration, end of prepaid term or customer notification - is cleared and not replaced, the failed-scheduled-actions log now records which subscription and event were affected and when the event should have run. Previously nothing in the WooCommerce logs identified the subscription, so a subscription left with a date and no scheduled action could only be found by hand.
• Fix: A product name containing HTML is now shown as plain text on the Subscriptions by Product report, instead of being rendered into the page.
• Fix: A finished Subscriptions health check scan now reports how many subscriptions it went through, matching the subscriptions list, instead of the smaller number of subscriptions the checks shortlisted.
• Fix: Visiting a change payment method link without its 'key' query argument no longer emits an "Undefined array key" PHP warning.
• Fix: An order-pay URL carrying an empty order key no longer triggers a fatal error when the order it names does not exist.
• Fix: On stores that display prices including tax, recurring totals in the block cart and checkout now note the tax included in the total, matching the "Total due today" row.
• Fix: The recipient of a gifted subscription is no longer shown the remove item control on My Account > Subscriptions. The control was never usable by them — removing a line item has always required the subscription's owner.
• Fix: A single product that fails to migrate no longer stops the All Products for Subscriptions product data migration for the whole catalog. Products it cannot migrate are logged and may be left at the default "Sell one-time only" mode; the completion notice reports how many failed with a link to the log so they can be checked and set up by hand.
• Fix: On stores using high-performance order storage, the Orders screen now warns before trashing a parent order that will also trash its linked subscriptions.
• Fix: Restored automatic completion of zero-total subscription switch orders placed through the block checkout on WooCommerce 10.9 and newer.
• Fix: Scheduled downloadable products linked to a subscription product now grant download permissions to existing subscribers when published at their scheduled time, instead of only when published manually from the admin.
• Fix: Saving a subscription product with no linked downloadable products no longer logs a PHP warning.
• Fix: Scheduled renewal payments no longer fail with a fatal error when another plugin checks an order's status while the renewal order is created in the background, which left subscriptions on hold and customers uncharged.
• Fix: The subscription plans script now loads only on pages that can show subscription options, instead of on every page of the store.
• Fix: Selecting a subscription plan inside a theme's quick view modal updates the price and the add-to-cart button again, as it did before 9.0.0.
• Fix: Paying for a pending or failed switch order from My Account or an emailed invoice link now completes the switch, instead of creating a second subscription alongside the one being switched.
• Fix: On stores with prices entered inclusive of tax, paying for a renewal through checkout now charges the correct total for subscriptions with a manual discount, instead of applying the discount inflated by the tax rate and under-charging the renewal.
• Fix: Subscriptions created from the admin screen now record whether the store enters prices inclusive of tax, so their orders are charged and discounted at the right total instead of treating tax-inclusive prices as tax-exclusive.
• Fix: Line items bought under a plan set to "Do not stop until cancelled" before All Products for Subscriptions was merged into Subscriptions in 9.0.0 are matched to that plan again. They had stopped being recognized as subscriptions, so recurring and sign-up fee coupons were rejected as not applicable to the product, plan pricing was not applied, and a customer could switch to the plan they were already on instead of being told they cannot switch to the same subscription. On affected stores, switch quotes for these subscriptions now use the purchased plan's billing schedule and free trial. A switch taken during a free trial is treated as leaving the trial: the new plan is charged and the trial ends, where previously nothing was due and the trial continued.
• Fix: PayPal payment notifications and API payloads are now reduced to the fields needed to diagnose a payment before being written to the diagnostic logs, so those entries no longer record the keys that authorize changing a subscription's payment method. The store's PayPal debug setting is also no longer overridden for ordinary orders.
• Fix: PayPal Standard subscription sign ups and payments are now checked as having been made to the store's PayPal account and in the subscription's currency, and payments also for the amount PayPal was asked to bill. A payment that does not match is not recorded and the reason is noted on the subscription. An active subscription is put on hold, its PayPal profile is suspended, and the customer is sent a renewal invoice whose payment moves the subscription to a new PayPal profile for the right amount.
• Fix: On stores that leave the optional PayPal "Receiver email" setting blank, a PayPal Reference Transactions payment notification for an order not yet marked paid is no longer put on hold as coming from a different email address.
• Fix: On stores using high-performance order storage, resubscribe orders no longer retain the PayPal payment details (payer name and address, subscriber and transaction IDs) recorded on the original subscription by older versions of the plugin.
• Fix: On stores using high-performance order storage without compatibility mode, a PayPal Standard payment notification resent by PayPal is again recognized as already processed. Re-processing a resend could leave a just-renewed subscription on hold with its next payment date in the past. The same fix restores cancelling the previous PayPal profile after a payment method change, and recording renewal payments on stores with a PayPal identity token set.
• Tweak: Add to Subscription now shows the same "cannot be edited" notice whether a subscription does not exist or belongs to another customer, instead of naming permission as the reason.
• Dev: Developer-facing changes
• Deprecated 'woocommerce_subscriptions_max_customer_suspension_range'. The redesigned suspension controls have no option list; the new settings support any number of suspensions.
• Deprecated WCSG_Admin::get_gifting_option_text and WCSG_Admin::get_gifting_global_override_text. Both described the removed storewide gifting default and nothing in the plugin renders their output anymore.
• Deprecated WC_Subscriptions_Admin::add_subscription_settings_tab. The Subscriptions tab is now registered as a WC_Settings_Page on 'woocommerce_get_settings_pages' rather than through 'woocommerce_settings_tabs_array'. The method now logs a deprecation notice when called, but still adds the tab, so third-party code that hooks it to 'woocommerce_settings_tabs_array' keeps working.
• Deprecated WC_REST_Subscriptions_Settings. It and all Subscriptions settings in the /wc/v3/settings REST API are now registered by the new Settings_Page class.
• In the /wc/v3/settings/subscriptions REST group, woocommerce_subscriptions_max_customer_suspensions is now registered as a 'number' field without an options list, instead of a 'select' field listing 0-12 and 'unlimited'. The values the field reads and accepts are unchanged: a non-negative integer, or 'unlimited'.
• WCS_ATT_Product::get_instance_id no longer re-runs APFS module initialization or the 'wcsatt_modules' and 'wcsatt_management_modules' filters.
• wcs_can_items_be_removed now requires the 'edit_shop_subscription_line_items' capability, which only a subscription's owner holds, and returns false when there is no current user. It takes an optional $user_id, defaulting to the current user. The 'wcs_can_items_be_removed' filter still runs, and now receives that user as a third argument, but it is applied before the capability check and so can no longer be used on its own to show the remove item control.