wcs-renewal-scheduler

Coordinate WooCommerce Subscriptions renewal dates and retry logic via WC_Subscription methods.

21|1|Updated Apr 29, 2026
One-click install
npx skills add https://github.com/Lonsdale201/wp-agent-skills --skill wcs-renewal-scheduler
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wcs-renewal-scheduler
Source: https://github.com/Lonsdale201/wp-agent-skills/tree/main/woocommerce/wcs-renewal-scheduler
Command: npx skills add https://github.com/Lonsdale201/wp-agent-skills --skill wcs-renewal-scheduler

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Coordinate renewal timing and retry logic for WooCommerce Subscriptions by ensuring date updates and renewal actions pass through the official scheduler and WC_Subscription methods.

Core Features & Use Cases

  • Update renewal dates using WC_Subscription::update_dates() to ensure validation, scheduling, and correct hook firing.
  • Create and attach renewal orders with wcs_create_renewal_order() and respond to wcs_renewal_order_created.
  • Handle renewal outcomes with the proper hooks (e.g., woocommerce_subscription_renewal_payment_complete) and safe retry flows using WCS.

Quick Start

Update subscription dates via WC_Subscription methods to reschedule renewals safely.

Frequently Asked Questions about wcs-renewal-scheduler

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely update WooCommerce subscription renewal dates?

To safely update WooCommerce subscription renewal dates, use the WC_Subscription::update_dates() method. This ensures proper validation, scheduler awareness, and correct hook firing when changing next_payment, trial_end, end, or payment_retry dates.

What is the correct way to create WooCommerce renewal orders?

The correct way to create WooCommerce renewal orders is using the wcs_create_renewal_order() function. You should then respond to the wcs_renewal_order_created hook to properly attach and handle the renewal order within the subscription lifecycle.

How does WooCommerce handle subscription renewal payment retries?

WooCommerce subscription renewal payment retries are handled through safe retry flows using WCS hooks like woocommerce_subscription_renewal_payment_complete. Updating payment_retry dates requires strict date validation and scheduler awareness via WC_Subscription methods.

Why should I use WC_Subscription methods instead of directly modifying subscription dates in the database?

Using WC_Subscription methods instead of direct database modification ensures renewal timing passes through the official scheduler. This guarantees proper validation, scheduled action handling, and correct hook execution for renewal orders and date updates.

Can I use custom hooks when creating or updating WooCommerce renewal orders?

Yes, you can use custom hooks when creating or updating WooCommerce renewal orders. The system supports responding to wcs_renewal_order_created and handling outcomes via woocommerce_subscription_renewal_payment_complete for safe retry logic and renewal order management.