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

# Subscription Downgraded: Track Plan Downgrades

> Track when subscribers downgrade their plan. Measure contraction revenue from downsells.

<Tip>
  Subscription Downgraded counts the number of subscribers who downgrade to a lower-tier plan.
</Tip>

## Formula

<Info>
  **Subscription Downgraded** = **COUNT** ( subscription\_downgraded events )
</Info>

### Formula Components

| Metric                              | Definition                                           |
| ----------------------------------- | ---------------------------------------------------- |
| **subscription\_downgraded events** | Events fired when a subscriber downgrades their plan |

| Metadata        |                         |
| --------------- | ----------------------- |
| **Type**        | Number                  |
| **Data Source** | [Upstack Pixel](/pixel) |
| **Aggregation** | Count                   |

***

## Example

Your SaaS application tracked **45 subscription\_downgraded events** in January.

| Metric                  | Value | Notes                  |
| ----------------------- | ----- | ---------------------- |
| Active Subscriptions    | 2,340 | Total active subs      |
| Subscription Downgraded | 45    | Downgrades this month  |
| Downgrade Rate          | 1.9%  | Monthly downgrade rate |

***

## How It Works

The Upstack pixel tracks `subscription_downgraded` events when a subscriber moves to a less expensive plan tier. This includes plan downgrades, seat removals, or any contraction of subscription value.

***

## When to Use

| Scenario               | Action                                |
| ---------------------- | ------------------------------------- |
| Contraction tracking   | Monitor downgrade rates               |
| Churn prediction       | Downgrades often precede cancellation |
| Pricing analysis       | Identify pricing friction             |
| Retention intervention | Target downgrades for win-back        |

***

## Related Metrics

| Metric                                                                                               | Relationship                    |
| ---------------------------------------------------------------------------------------------------- | ------------------------------- |
| [Subscription Downgraded Cost](/reference/metrics/funnel/conversions/subscription-downgraded-cost)   | Cost associated with downgrades |
| [Subscription Downgraded Value](/reference/metrics/funnel/conversions/subscription-downgraded-value) | MRR lost to downgrades          |
| [Subscription Upgraded](/reference/metrics/funnel/conversions/subscription-upgraded)                 | Opposite direction              |

[See all Conversions metrics →](/reference/metrics/funnel/conversions)