# 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="/files/ZBHcK2wINpQ33pqppEo3" 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="/files/ASyU5LpM20U5NXajkW9u" 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="/files/Xmc0c4sOZoMdh0KOwvAL" 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.letsmetrix.com/shopify-metrics/upgrades-and-downgrades.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.