woocommerce-subscriptions
This skill teaches you to create subscription products in WooCommerce with configurable billing periods, free trials, and sign-up fees. Learn to hook into subscription lifecycle events—activation, renewal success, payment failure, and cancellation—to automate access control and business logic. Handle plan upgrades, downgrades, and payment retries programmatically.
WooCommerce Subscriptions lets you build recurring billing products with automated renewal and lifecycle management hooks.
AI-generated summary based on this skill's SKILL.md
Install
finsilabs/awesome-ecommerce-skills/woocommerce-subscriptions · repository language: JavaScript
git clone https://github.com/finsilabs/awesome-ecommerce-skills
cp -r awesome-ecommerce-skills/skills/platform-woocommerce/woocommerce-subscriptions ~/.claude/skills/woocommerce-subscriptionsnpx skillfed install finsilabs/awesome-ecommerce-skills/woocommerce-subscriptionsFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How do I create subscription products in WooCommerce?
WooCommerce Subscriptions lets you create subscription products by setting a billing period (weekly, monthly, yearly, etc.), optional free trial, and sign-up fee. When a customer purchases, the plugin automatically handles recurring charges on the configured schedule. You define the product type as 'subscription' and configure renewal terms in the product settings.
How does WooCommerce Subscriptions handle payment failures and retries?
WooCommerce Subscriptions monitors renewal payments and detects failures automatically. When a payment fails, the plugin triggers retry logic and fires hooks like `woocommerce_subscription_payment_failed` so you can log the event, notify the customer, or pause access. You can customize retry schedules and failure notifications via filters and email templates.
What hooks and filters does WooCommerce Subscriptions provide?
WooCommerce Subscriptions exposes hooks for subscription lifecycle events: `woocommerce_subscription_activated`, `woocommerce_subscription_renewal_payment_complete`, `woocommerce_subscription_payment_failed`, and `woocommerce_subscription_cancelled`. Filters let you modify renewal amounts, control access, and query subscriptions programmatically. These enable custom business logic without modifying core code.
How do I manage subscription upgrades, downgrades, and proration?
WooCommerce Subscriptions calculates proration automatically when customers switch plans. The plugin adjusts the renewal amount based on the price difference and remaining billing period. You can trigger plan changes via the customer portal or programmatically using subscription update functions, and the proration logic ensures fair billing for partial periods.
Can I integrate payment gateways like Stripe with subscriptions?
WooCommerce Subscriptions integrates with major payment gateways including Stripe, PayPal, and Square. Each gateway handles tokenization and recurring charges according to its API. You configure the gateway in WooCommerce settings, and the plugin manages subscription renewals through the gateway's recurring payment infrastructure.
How do I query and control subscriptions programmatically?
WooCommerce Subscriptions provides functions to retrieve subscriptions by user, status, or product. Use `wcs_get_users_subscriptions()` to fetch customer subscriptions, then access properties like renewal date, status, and plan. Hooks and filters let you intercept lifecycle events to implement custom access control, logging, or automation tied to subscription state changes.
SKILL.md
rendered from the published skill — quoted content, verbatim
WooCommerce Subscriptions
Overview
WooCommerce Subscriptions (the official premium plugin) adds subscription product types — simple subscriptions and variable subscriptions — with configurable billing periods (daily, weekly, monthly, yearly), free trials, sign-up fees, and prorated upgrades/downgrades. It integrates with Stripe, PayPal Reference Transactions, and other gateways that support automated recurring billing. Custom logic hooks into the subscription lifecycle via a rich set of WordPress actions and filters.
When to Use This
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 8 files
skills/platform-woocommerce/woocommerce-subscriptions/SKILL.md
skills/platform-woocommerce/woocommerce-subscriptions/evals/failed-payment-retry-suspension-and-rein/criteria.json
skills/platform-woocommerce/woocommerce-subscriptions/evals/failed-payment-retry-suspension-and-rein/task.md
skills/platform-woocommerce/woocommerce-subscriptions/evals/plan-switching-with-proration-and-safe-c/criteria.json
skills/platform-woocommerce/woocommerce-subscriptions/evals/plan-switching-with-proration-and-safe-c/task.md
skills/platform-woocommerce/woocommerce-subscriptions/evals/subscription-product-creation-and-lifecy/criteria.json
skills/platform-woocommerce/woocommerce-subscriptions/evals/subscription-product-creation-and-lifecy/task.md
skills/platform-woocommerce/woocommerce-subscriptions/tile.json