---
title: Subscriptions Guide
description: Configuring and managing recurring payments.
---

WooNooW's Subscriptions module seamlessly integrates with your store, enabling recurring revenue streams for your products or services.

## Setup Requirements
To use Subscriptions, ensure:
1. The **Subscriptions** module is toggled ON under **WooNooW > Settings > Modules**.
2. Your payment gateway supports tokenization / recurring payments (e.g., Stripe, PayPal).

## Creating a Subscription Product

WooNooW implements subscriptions directly within the standard product settings, eliminating the need for separate product types.

1. Go to **Products** in the Admin SPA and create or edit a product.
2. In the **General** tab, scroll down and check **Enable subscription for this product**.
3. Configure the billing schedule:
   - **Period & Interval:** How often they are charged (e.g., every 1 month).
   - **Trial Days:** Offer an initial period at no cost (e.g., 14 days).
   - **Signup Fee:** Optional one-time fee added to the first payment.

> [!NOTE]
> For variable products, you can configure these subscription settings at the variation level in the **Variations** tab, allowing different billing terms for different variations.

## Managing Subscriptions (Admin)
Store owners can view and manage all active, paused, or cancelled subscriptions directly from the Admin SPA.
1. Navigate to **Store > Subscriptions**.
2. Click on any Subscription ID to view details.
3. From the detail view, you can:
   - **Pause/Resume** an active subscription.
   - **Cancel** a subscription.
   - **Renew Now**: Initiates a standard renewal process.
   - **Charge Now**: Bypasses gateway capability checks to attempt an immediate auto-debit charge. If it fails, the order is marked as failed without falling back to a manual payment link.

## Customer Experience
When a customer purchases a subscription, they gain access to a self-service dashboard in their account:

1. Customers navigate to **My Account > Subscriptions**.
2. They can view the status, next payment date, and associated orders.
3. They have autonomy to take actions like **Pause**, **Resume**, or **Cancel** their own subscriptions.
   - **Pause Limits:** If configured in settings, customers are restricted to a maximum number of pauses (e.g., max 3 pauses per subscription). The UI clearly displays how many pauses are remaining.
4. **Early Renewals:** Customers can choose to renew early. When paying for an early renewal, the UI clearly displays the projected next billing date so they know exactly when their subsequent charge will occur.
5. If a payment fails, customers will see a clear **Pay Now** button to update their billing details.

## Automated Emails
The notification system automatically handles subscription lifecycle events:
- **New Subscription:** Welcome email for the recurring plan.
- **Renewal:** Receipt for a successful periodic charge.
- **Failed Renewal:** Action required notification to update payment info.
- **Cancelled/Expired:** Confirmation of plan termination.

You can customize these templates under **Settings > Notifications**.
