Documentation – WooCommerce Subscription Product Creation

A step-by-step guide to configuring and publishing your first subscription product in WooCommerce.

YeeSubscriptions adds a specialized product type directly into the native WooCommerce product editor. Follow these steps to build your offering:

  1. Create a New Product: Navigate to Products > Add New from your WordPress admin dashboard.
  2. Select Product Data Type Simple product -> Checked Subscription
  3. Configure Pricing and Billing Cycle: Once the Subscription is selected, the General tab will update to display subscription-specific pricing fields

Configure Pricing and Billing Cycle: Once the Subscription checkbox is selected, the General tab will update to display subscription-specific fields. Configure your subscription parameters as follows:

  • One-time Purchase: Check this box if you want to allow customers to buy this product as a regular, non-recurring item in addition to the subscription option.
  • Subscription price ($): Set the recurring amount and frequency. Enter the monetary value in the first field, then use the dropdowns to specify the interval (e.g., every, every 2nd, etc.) and period (day, week, month, year).⚠️ Note: To offer a free subscription or handle custom pricing via API, you can input 0.00. However, ensure your payment gateway supports zero-dollar recurring schemes before launching.
  • Stop renewing after: Define the lifespan of the subscription. Select Never stop renewing for an ongoing billing cycle that requires manual cancellation, or choose a specific duration (e.g., 12 months) after which the subscription will automatically expire.
  • Sign-up fee ($): Enter an optional initial fee charged only at the moment of registration. This is an upfront cost added to the regular subscription amount for the first billing cycle. Leave blank if there is no setup cost.
  • Free trial: Offer a complimentary testing period before the billing cycle kicks in. Input a number and choose the time unit (days, weeks, months, years). The system will delay the first recurring payment until this trial period ends.
  • Sale price ($): Set a discounted recurring price if you are running a promotional campaign.
  • PayPal Plan ID: For seamless PayPal Billing integration, input the corresponding remote Plan ID (e.g., P-XXXXXXXXXXXXXXXXXXXXX). This binds your WooCommerce product metrics directly to the automated PayPal Billing engine.
  • Variable Plans: Check this option if you intend to convert this into a variable subscription product, allowing you to define distinct pricing variations (e.g., Tier 1, Tier 2) under a single product entry.

Configure Variable Plans:

When the Variable Plans checkbox is selected, the interface expands to allow you to create and manage multiple pricing tiers or subscription options within a single product.

  • Use Global Plans: Check this box if you want to link this product to globally predefined subscription templates instead of creating custom plans for this specific product.
  • Subscription Plans Section: Click the Add Plan button to dynamically generate a new plan block. You can add multiple blocks to build a flexible pricing matrix (e.g., Monthly, Yearly tiers). Each plan contains the following settings:
    • Plan Name: Enter a descriptive name for this specific tier (e.g., Monthly Delivery, Premium Access). This name will be visible to customers at checkout.
    • Subscription price: Define the billing frequency for this specific plan using the dropdown menus (e.g., every month, every 3 months).
    • Stop renewing after: Set the expiration duration for this tier, or keep it at Never stop renewing for continuous automated billing.
    • Price Fields:
      • Regular Price ($): Set the standard recurring amount to charge for each cycle.
      • Sale Price ($): Enter an optional promotional recurring price for marketing campaigns.
    • PayPal Plan ID: Displays Auto-generated on save. The system will automatically handle the API communication with PayPal and fetch a remote Plan ID once you click Update/Publish the product.
    • Remove Button: Click the Remove button in the top-right corner of any plan block to delete that specific tier from the product.

Customize Frontend Display via Settings:

Beyond the product-level setup, you can fully control how these Variable Plans are styled and presented to your customers on the frontend. Navigate to WooCommerce > Settings->Subscriptions