# Upgrades & Downgrades

### How we get these data 

Upgrades & Downgrades data is gathered from Shopify API App Events to support product optimization and revenue growth strategies.

### Understand the dashboard

A metric tracking customer movement between paid plans (Paid Plans):

* **Upgrade:** User switches from a lower paid plan to a higher paid plan (Increases MRR).
* **Downgrade:** User switches from a higher paid plan to a lower paid plan (Decreases MRR).

**Note:** Switching from "Paid" to "Free" is counted in "Churned Subscription", not counted in Downgrade.

#### 1. Upgrades & Downgrades

The line chart visualizes the net movement trend over your selected time period.

<figure><img src="https://3107817457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8KaEyTr3mMTLCU7QQyAU%2Fuploads%2FASeI3gyMu2PpN8jarl07%2Funknown.png?alt=media&#x26;token=cdb67488-995a-40ff-8966-667a34ddf3d6" alt="" width="563"><figcaption></figcaption></figure>

The breakout table provides a daily breakdown of these movements, categorizing them into **Expansion** (Upgrades), **Contraction** (Downgrades), and the resulting **Net change**.

The panels below offer a quick historical comparison of your current net changes against benchmarks from 1, 3, 6, 12, and 24 months ago.

<figure><img src="https://3107817457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8KaEyTr3mMTLCU7QQyAU%2Fuploads%2FSJlDR1OKUOeIYdafXVT6%2Funknown.png?alt=media&#x26;token=55ae5bdd-952f-4966-83b2-3e711ea3089b" alt="" width="563"><figcaption></figcaption></figure>

#### 2. Monthly Growth

This bar chart displays the monthly performance of plan movements, visually comparing **Expansion** against **Contraction**, with a black line representing the **Net** result for each month.

<figure><img src="https://3107817457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8KaEyTr3mMTLCU7QQyAU%2Fuploads%2F5BxTbGsKscDwg82N2eiK%2Funknown.png?alt=media&#x26;token=c69db508-eb17-4bb5-96f2-da4f53c82d2a" alt="" width="563"><figcaption></figcaption></figure>

**How Upgrades & Downgrades data can benefit you**

* **Measuring Expansion Revenue:** Upgrades are a strong indicator that users perceive increasing value from your application and are willing to pay more for advanced features.
* **Warning for Pricing Value:** Downgrades serve as a warning that users may feel a premium package is not worth its current price, although they still find enough value to keep the app rather than uninstalling it entirely.