# Subscription

> The values of `subscription` inside `customer-subscription` or `subscription-page`.

Status: Ready (Smootify 2.0)  
URL: https://www.smootify.io/docs/reference/attributes/subscription  
Updated: 2026-10-13

## At a glance

| Status | Forms that stay | Forms removed |
|---|---|---|
| `ACTIVE` | `subscription-pause`, `subscription-cancel` | `subscription-activate` |
| `PAUSED` | `subscription-activate`, `subscription-cancel` | `subscription-pause` |
| `CANCELLED` | none | all three |
| `EXPIRED` | none | all three |

More in [the guide](https://www.smootify.io/docs/build/account-subscriptions).

## Where it can go

- **Inside any of:** [`customer-subscription`](https://www.smootify.io/docs/reference/elements/customer-subscription), [`subscription-page`](https://www.smootify.io/docs/reference/elements/subscription-page).
- On text.

## Values

| Attribute and value | What it is | Notes |
|---|---|---|
| `subscription="name"` | Name | — |
| `subscription="status"` | Status | — |
| `subscription="nextBillingDate"` | Next billing | also read as next-billing-date |
| `subscription="cancelReason"` | Cancel reason | also read as cancel-reason |
| `subscription="totalPrice"` | Total | also read as total-price |
| `subscription="subtotalPrice"` | Subtotal | also read as subtotal-price |
| `subscription="billingInterval"` | Billing interval | also read as billing-interval |
| `subscription="totalTax"` | Taxes | also read as total-tax |
| `subscription="totalRefunded"` | Refunded | From the order that started the subscription; also read as total-refunded |
| `subscription="shippingPrice"` | Shipping | also read as shipping-price |
| `subscription="shippingAddress"` | Shipping address | also read as shipping-address |
| `subscription="billingAddress"` | Billing address | also read as billing-address |
| `subscription="createdAt"` | Created on | also read as created-at, processed-at, processedAt |
| `subscription="note"` | Note | — |
| `subscription="url"` | Subscription page | on link |
| `subscription="statusUrl"` | Status page | on link; also read as status-url |
| `subscription="customerUrl"` | Account page | on link; also read as customer-url |
