> For the complete documentation index, see [llms.txt](https://help.openloyalty.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.openloyalty.io/gamification/tiers/tier-metrics.md).

# Tier Metrics

The tier metrics dashboard gives you a numeric summary of your tier program: how many members you have, how they are spread across tiers, how long they stay, and which way they are moving. Read together, these cards tell you whether the program is growing, whether members are climbing or slipping, and whether your tier thresholds are set right.

Use the **Timeframe** filter to change the period each card covers, and the **Filters** control to narrow the view to specific tiers. Every card compares the selected period against the previous period of the same length.

<figure><img src="/files/RDYolduWyOntBz7rYUsJ" alt=""><figcaption></figcaption></figure>

### Total tierset movement

How many members changed tier during the period, split into upgrades (moved to a higher tier) and downgrades (moved to a lower tier), each with its share of the total. The bar shows the balance at a glance: green when upgrades lead, orange when downgrades lead. A run of downgrades is worth investigating, a common cause is a wave of expiring tier statuses.

<figure><img src="/files/8fqte5ExSR1XA02VpsXz" alt=""><figcaption></figcaption></figure>

### Total members in tierset

Shows the total number of members assigned to any tier in the tier set, the change versus the previous period, and a trend line comparing the current period against the previous one. Hover over the trend line to see the exact numbers for any point in time.

A rising total means acquisition and retention are working together. A falling total means you are losing members or acquiring fewer of them, and the composition and movement metrics below can help you find where.

<figure><img src="/files/fE6ZPflbJ95bhWK4q6rJ" alt=""><figcaption></figcaption></figure>

### Tierset composition

How your members are split across the tiers, shown as a count and a percentage per tier for the current and previous period. A healthy program usually forms a pyramid, with most members in the entry tier and fewer in each tier above. A sharp change in one tier's share tells you members moved; the movement cards tell you which way.

<figure><img src="/files/VKZtans9wfBzqk2ryDeo" alt=""><figcaption></figcaption></figure>

### Average and median time per tier

How long members stay in each tier before moving up or down, shown as the average (AVG) and median (MED) days for each tier. Only members who left the tier during the period are counted. When the two values are close, members move through at a similar pace; when the average sits well above the median, a small group is lingering far longer than the typical member, for example dormant accounts in an entry tier.

<figure><img src="/files/NHwyvuExfOA91JdZFvV9" alt=""><figcaption></figcaption></figure>

### Net movement per tier

Breaks movement down tier by tier: for each tier, how many members moved in from a lower tier (upgrades) and how many moved out to a lower tier (downgrades), with the net change. This lets you see which specific tier is gaining or losing members. You can see this card in the bottom right of the dashboard overview above.

<figure><img src="/files/2MjxKJHChOM08DTjjt85" alt=""><figcaption></figcaption></figure>

### Reading the cards

Two situations change what the cards display:

**No previous period data.** If there is no earlier period to compare against, for example in a newly launched program, the cards show the current values with a note that no comparison is available.

<figure><img src="/files/S1u5y3pSbk5DVINVFjjC" alt="" width="468"><figcaption></figcaption></figure>

**No movement.** If the numbers are identical to the previous period, the change badge shows 0.00% and the card notes that there was no movement against the previous period.

<figure><img src="/files/zgr3OtlyWeIvye0A1etP" alt=""><figcaption></figcaption></figure>

### Filtering by tier

The **Filters** control changes the scope of every card on the dashboard.

Selecting a single tier switches the cards to that tier only. The card titles change to match, for example Total "Bronze" Tier Movement and Total Members in "Bronze" Tier.

<figure><img src="/files/uZf8aNszRIUHPbbRnUYf" alt="" width="470"><figcaption></figcaption></figure>

Selecting several tiers shows the combined view for just those tiers, and the card titles change to Total Selected Tiers Movement and Total Members in Selected Tiers.

<figure><img src="/files/uNtM4SjLOF3Mv4E7wVHy" alt="" width="452"><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://help.openloyalty.io/gamification/tiers/tier-metrics.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.