> ## 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 Upgraded: Track Plan Upgrades

> Track when subscribers upgrade their plan. Measure expansion revenue from upsells.

<Tip>
  Subscription Upgraded counts the number of subscribers who upgrade to a higher-tier plan.
</Tip>

## Formula

<Info>
  **Subscription Upgraded** = **COUNT** ( subscription\_upgraded events )
</Info>

### Formula Components

| Metric                            | Definition                                         |
| --------------------------------- | -------------------------------------------------- |
| **subscription\_upgraded events** | Events fired when a subscriber upgrades their plan |

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

***

## Example

Your SaaS application tracked **156 subscription\_upgraded events** in January.

| Metric                | Value | Notes                |
| --------------------- | ----- | -------------------- |
| Active Subscriptions  | 2,340 | Total active subs    |
| Subscription Upgraded | 156   | Upgrades this month  |
| Upgrade Rate          | 6.7%  | Monthly upgrade rate |

***

## How It Works

The Upstack pixel tracks `subscription_upgraded` events when a subscriber moves to a more expensive plan tier. This includes plan upgrades, seat additions, or any expansion of subscription value.

***

## When to Use

| Scenario             | Action                                |
| -------------------- | ------------------------------------- |
| Expansion tracking   | Monitor upsell and upgrade success    |
| Product adoption     | Identify features driving upgrades    |
| Campaign attribution | Measure upsell campaign effectiveness |
| Revenue growth       | Track expansion MRR contribution      |

***

## Related Metrics

| Metric                                                                                           | Relationship          |
| ------------------------------------------------------------------------------------------------ | --------------------- |
| [Subscription Upgraded Cost](/reference/metrics/funnel/conversions/subscription-upgraded-cost)   | Cost per upgrade      |
| [Subscription Upgraded Value](/reference/metrics/funnel/conversions/subscription-upgraded-value) | Revenue from upgrades |
| [Subscription Downgraded](/reference/metrics/funnel/conversions/subscription-downgraded)         | Opposite direction    |

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