> ## 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 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.

## Formula

> [!NOTE]
>
> **Subscription Downgraded** = **COUNT** ( subscription\_downgraded events )

### Formula Components

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

| Metadata | |
| - | - |
| **Type** | Number |
| **Data Source** | [Upstack Pixel](https://docs.upstackdata.com/pixel.md) |
| **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](https://docs.upstackdata.com/reference/metrics/funnel/conversions/subscription-downgraded-cost.md) | Cost associated with downgrades |
| [Subscription Downgraded Value](https://docs.upstackdata.com/reference/metrics/funnel/conversions/subscription-downgraded-value.md) | MRR lost to downgrades |
| [Subscription Upgraded](https://docs.upstackdata.com/reference/metrics/funnel/conversions/subscription-upgraded.md) | Opposite direction |

[See all Conversions metrics →](https://docs.upstackdata.com/reference/metrics/funnel/conversions)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.