> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gameball.co/llms.txt
> Use this file to discover all available pages before exploring further.

# How Do I Send Real-Time Notifications on Tiers?

> Notify your customers upon tiering up using Gameball's real-time notifications.

Available for all Gameball customers except for free packages

When a customer meets the requirements needed to join a higher tier, it is important to inform them that they are now on that new level so they can check the benefits they can now enjoy and engage more.

***

## How to Create Real-Time Notifications for When a New Tier is Reached

<Steps>
  <Step title="Navigate to Tier Notifications">
    In the **Gameball Admin Dashboard**, from the left bar, click **Notifications**. Choose between **In-App, Emails, & SMS**. Scroll to **Tiers** and select **Tier Achieved**.

    <Frame>
      <img src="https://mintcdn.com/gameball/0izDrUbnPHPlIUcS/images/product-docs/instant-notifications/real-time-notifications-per-program/tiers-navigation.png?fit=max&auto=format&n=0izDrUbnPHPlIUcS&q=85&s=b7c4cda6e70cf2c1908ee109245773d0" alt="Tiers navigation" width="3082" height="1672" data-path="images/product-docs/instant-notifications/real-time-notifications-per-program/tiers-navigation.png" />
    </Frame>
  </Step>

  <Step title="Write the Notification Message">
    Construct a heading and a body for the notification. In case you are creating an email notification, write a clear subject line and body. [Learn how to write an email notification](/product-documentation/instant-notifications/email-notifications/sending-achievement-emails).
  </Step>

  <Step title="Configure the Achieved Tier Script">
    Send a real-time notification to your customers upon leveling up to a higher tier. Let them know the name of the new tier they are on, the tier entry reward if there is any, and ask them to check the new tier's benefits.
  </Step>

  <Step title="Add Script Variables">
    To send more personalized, relevant, and clear notifications, add variables in between your messages by clicking the **+ icon**.

    <Frame>
      <img src="https://mintcdn.com/gameball/0izDrUbnPHPlIUcS/images/product-docs/instant-notifications/real-time-notifications-per-program/script-variables-tier.png?fit=max&auto=format&n=0izDrUbnPHPlIUcS&q=85&s=6805ee46703ad0ebd5f913408b11ba7f" alt="Script variables" width="2500" height="1180" data-path="images/product-docs/instant-notifications/real-time-notifications-per-program/script-variables-tier.png" />
    </Frame>

    You can use variables in the scripts like the ones below:

    * **Customer Variables:** First Name, Display Name, Customer's Email, Referral Link, Mobile Referral Link, Tier-up Progress, Points, Points Before, Tier Up total progress, Total Friends Referred.
    * **Tier Variables:** Equivalent value of total points, Equivalent value of earned points, Currency, Points Name, Achieved tier, Previous Tier, Next Tier, Tier rewarded points, Referral Link, Mobile Referral Link, Tier Entry Reward, Tier Lifetime Reward.
  </Step>

  <Step title="Preview and Update Notification Icon">
    Before activating the notification, click **Preview** on the top right of the edit page to see what the notification will look like for customers.

    <Frame>
      <img src="https://mintcdn.com/gameball/0izDrUbnPHPlIUcS/images/product-docs/instant-notifications/real-time-notifications-per-program/preview-notification-tier.png?fit=max&auto=format&n=0izDrUbnPHPlIUcS&q=85&s=4f90ffcadcb6188679cc2de95aefc3a0" alt="Preview notification" width="2010" height="844" data-path="images/product-docs/instant-notifications/real-time-notifications-per-program/preview-notification-tier.png" />
    </Frame>

    You can edit the notification icon by choosing **Upload Icon**, then click **Upload Icon**.

    <Frame>
      <img src="https://mintcdn.com/gameball/0izDrUbnPHPlIUcS/images/product-docs/instant-notifications/real-time-notifications-per-program/upload-icon-dialog-tier.png?fit=max&auto=format&n=0izDrUbnPHPlIUcS&q=85&s=6b47b9d47d10aa91a6315800e5e9037b" alt="Upload icon dialog" width="2538" height="1494" data-path="images/product-docs/instant-notifications/real-time-notifications-per-program/upload-icon-dialog-tier.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/gameball/7dwj4uKg5t78O1BR/images/product-docs/instant-notifications/real-time-notifications-per-program/notification-icon-preview-tier.png?fit=max&auto=format&n=7dwj4uKg5t78O1BR&q=85&s=27ca02572215623f65aca770ded92a9d" alt="Notification icon preview" width="1133" height="650" data-path="images/product-docs/instant-notifications/real-time-notifications-per-program/notification-icon-preview-tier.png" />
    </Frame>

    Click **Update** from the bottom right.
  </Step>

  <Step title="Activate the Notification">
    Enable or disable the notification through the **Active Toggle**.

    <Frame>
      <img src="https://mintcdn.com/gameball/7dwj4uKg5t78O1BR/images/product-docs/instant-notifications/real-time-notifications-per-program/active-toggle-tier.png?fit=max&auto=format&n=7dwj4uKg5t78O1BR&q=85&s=51a0e7b227ace99b9d98aba7a0fdff61" alt="Active toggle" width="2458" height="1026" data-path="images/product-docs/instant-notifications/real-time-notifications-per-program/active-toggle-tier.png" />
    </Frame>

    <Note>
      Do not forget to click on "**Save**" before you exit.
    </Note>
  </Step>
</Steps>

***

## Related Articles

<CardGroup cols={2}>
  <Card title="Send Real-Time Notifications for Reward Campaigns" icon="trophy" href="/product-documentation/instant-notifications/real-time-notifications-per-program/reward-campaign-notifications">
    Keep customers informed of reward campaign unlocks, progress, and achievements.
  </Card>

  <Card title="Send Real-Time Notifications for Referrals" icon="people-arrows" href="/product-documentation/instant-notifications/real-time-notifications-per-program/referral-notifications">
    Alert customers when a referral is successful or when a referral reward is earned.
  </Card>

  <Card title="Send Real-Time Notifications for Cashback" icon="money-bill-wave" href="/product-documentation/instant-notifications/real-time-notifications-per-program/cashback-notifications">
    Notify customers of cashback rewards earned or canceled for their transactions.
  </Card>

  <Card title="Send Real-Time Notifications for Transactional Rewards" icon="coins" href="/product-documentation/instant-notifications/real-time-notifications-per-program/transactional-rewards-notifications">
    Notify customers about points redemption, refunds, and expiry events.
  </Card>

  <Card title="Sending Customers Emails Celebrating Achievements" icon="envelope" href="/product-documentation/instant-notifications/email-notifications/sending-achievement-emails">
    Send achievement emails to drive customers back to your platform.
  </Card>
</CardGroup>
