> For the complete documentation index, see [llms.txt](https://docs.roadmap.so/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roadmap.so/loyalty-and-rewards/points-and-ways-to-earn/award-points-for-tier-promotions.md).

# Award points for tier promotions

Award loyalty points when a customer is promoted into a membership tier, once per customer or on every promotion, with skipped tiers still paying out.

The **Tier Promotion** way to earn awards points the moment a customer is promoted into a tier you choose. It turns reaching a tier into an immediate, tangible win on top of the tier's ongoing perks.

### Set it up

{% stepper %}
{% step %}

#### Add the earner

In **Loyalty Program → Points**, click **Add way to earn** and choose **Tier Promotion**.
{% endstep %}

{% step %}

#### Choose the destination tier

There's a single condition: **When a customer is promoted to** your chosen tier. The tier they came from doesn't matter, and a customer who jumps past this tier still earns the points.
{% endstep %}

{% step %}

#### Set the points and frequency

Enter the **Points awarded**, then decide how often with **Only award once**: leave it on to award only the first time the customer ever reaches this tier, or turn it off to award every time they make this move, including earning the tier back after being demoted at a period recalculation.
{% endstep %}

{% step %}

#### Write the customer note

The **Customer note** is the reason for the award, and it appears on the customer's loyalty point history, for example *100 points for reaching Gold*.
{% endstep %}

{% step %}

#### Name the tile and activate

Set the **Display name** and **Description** shown in the loyalty widgets, keep or replace the icon, and set the status to **Active**.
{% endstep %}
{% endstepper %}

<figure><img src="https://393112916-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ8asLD4FVCFagK40xEr4%2Fuploads%2F17FLk6eNYhIpt53mbRa2%2FScreenshot%202026-09-08%20at%201.40.07%E2%80%AFPM.png?alt=media&amp;token=844d82da-e46c-4f79-9508-82d7a0103692" alt=""><figcaption></figcaption></figure>

Create one Tier Promotion earner per tier you want to reward, each with its own points.

### What counts as a promotion

Any move **up into** the configured tier awards the points, whether an order or point earner pushes the customer over the tier's milestone or you promote them manually.

{% hint style="info" %}
**Skipped tiers still pay.** If a customer jumps straight from Bronze to Platinum, every tier crossed fires its configured reward: they receive both the Gold promotion points and the Platinum promotion points in the same event.
{% endhint %}

### What doesn't count

Movements that aren't real milestone promotions don't award points:

* Joining or leaving the [tag-based secondary program](/loyalty-and-rewards/membership-tiers-and-referrals/tag-based-membership-tiers.md), including the recalculation that runs when a customer leaves it.
* Tier shifts connected to [B2B company loyalty](/loyalty-and-rewards/b2b-loyalty/b2b-loyalty-an-overview.md).
* Demotions, naturally: only upward moves award.

### Points or perks: combining with Customer Rewards

Tier Promotion awards **points**. If you'd rather greet a new tier with a reward itself (a discount, a gift), use [Reward customers for reaching a tier](/loyalty-and-rewards/membership-tiers-and-referrals/reward-customers-for-reaching-a-tier.md). The two combine well: points for the milestone, plus a tangible welcome-to-the-tier perk.

### Related guides

* [Ways to earn points: overview](/loyalty-and-rewards/points-and-ways-to-earn/ways-to-earn-points-overview.md)
* [Loyalty Tiers](/loyalty-and-rewards/membership-tiers-and-referrals/loyalty-tiers.md)
* [Reward customers for reaching a tier](/loyalty-and-rewards/membership-tiers-and-referrals/reward-customers-for-reaching-a-tier.md)
* [Loyalty membership eligibility settings](/loyalty-and-rewards/getting-started/loyalty-membership-eligibility-settings.md)


---

# 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://docs.roadmap.so/loyalty-and-rewards/points-and-ways-to-earn/award-points-for-tier-promotions.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.