> ## Documentation Index
> Fetch the complete documentation index at: https://docs.areawp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Subscriptions

> Full subscription lifecycle management — create, approve, extend, suspend, reject, and cancel client subscriptions.

<Info>
  **Path:** Administration → Subscriptions (`/subscriptions`) — Admin only
</Info>

## Subscription List

The page shows all subscriptions with search and filter controls:

| Filter             | Options                                 |
| ------------------ | --------------------------------------- |
| **Search**         | User name or email                      |
| **Status**         | Active / Pending / Cancelled / Past Due |
| **Plan**           | Filter by pricing plan                  |
| **Payment Method** | Stripe / PayPal / Tap / Bank Transfer   |

**Table columns:**

| Column      | Description                          |
| ----------- | ------------------------------------ |
| **User**    | Client name and email                |
| **Plan**    | Pricing plan name and billing period |
| **Status**  | Status badge                         |
| **Payment** | Payment method badge                 |
| **Started** | Subscription start date              |
| **Expires** | Current period end date              |

***

## Subscription Statuses

| Status           | Description                             |
| ---------------- | --------------------------------------- |
| 🟢 **Active**    | Paid and current                        |
| 🔵 **Pending**   | Awaiting admin approval (Bank Transfer) |
| 🟡 **Past Due**  | Payment failed — grace period           |
| 🔴 **Cancelled** | Canceled by user or admin               |
| ⚫ **Expired**    | Period ended without renewal            |

***

## Creating a Subscription

Click **Create Subscription** to open a 2-step modal:

1. **Select User** — search and pick the client account
2. **Choose Plan** — select pricing plan and billing period

***

## Managing a Subscription

Click any row to open the detail view. Available actions:

### Approve

For **Pending** subscriptions (Bank Transfer payments waiting for manual confirmation). Clicking **Approve** activates the subscription immediately.

### Reject

Reject a pending subscription with a mandatory reason field. The user is notified.

### Extend

Add days to the current billing period without charging:

* Input number of days to add
* Optional reason field (shown in the user's billing history)

Useful for compensating for outages or providing goodwill extensions.

### Change Status

Manually set the subscription status (active, suspended, cancelled, etc.) with a reason.

### Delete

Permanently remove the subscription record. Use with caution — this removes billing history.

***

## Modals Summary

| Modal                   | Purpose                           |
| ----------------------- | --------------------------------- |
| **Create Subscription** | 2-step: select user → choose plan |
| **Extend**              | Add days + reason                 |
| **Delete Confirmation** | Confirm permanent deletion        |
| **Status Change**       | Set status manually               |
| **Reject**              | Reject with reason                |

***

## Bulk Operations

Select multiple subscriptions from the list for bulk actions:

* Send renewal reminder emails
* Suspend multiple accounts
* Export as CSV for accounting