The Tier Progress block shows logged-in customers their current VIP tier, the next tier they're working towards, and how close they are to reaching it.
This block is only visible when the customer is logged in and VIP tiers are enabled on your loyalty program. Guests and stores without VIP tiers configured will not see this block.
How to Configure the Tier Progress Block
From your Shopify admin, open the Mage Loyalty app.
In the left menu, click Account Sidebar.
Click the Blocks tab.
Find the Tier Progress block and click on it to expand its settings.
Make sure the block toggle is turned on.
Fill in the Link URL and Link Text fields (see Field Reference below).
Click Save.
Note
If you don't have VIP tiers set up yet, this block will not appear on the storefront even when enabled. Configure your VIP tiers under Loyalty β VIP Tiers first.
Field Reference
Field | What It Does | Example |
Link URL | The destination customers go to when they click the link. We recommend linking to the VIP tier benefits table on your rewards page if you have one. Leave blank to hide the link entirely. | "/pages/rewards#tiers" |
Link Text | The text shown on the link. Only appears when a Link URL is set. Defaults to View perks. | "View perks" |
Common Mistakes to Avoid
Common Mistake
Linking to a page that doesn't explain the tiers: the link is most valuable when it sends customers to a page that shows the perks of each tier. Linking to your homepage or a generic rewards page is a missed opportunity.
Common Mistake
Leaving the Link URL blank: without a URL, the call to action disappears entirely, which can confuse customers who want to learn more about their tier benefits.
CSS Reference
If you're styling the Tier Progress block from your theme stylesheet or the sidebar's custom CSS field, these are the classes the block exposes.
Class | What it targets |
| The outer wrapper around the whole block. |
| The inner card container. |
| Top row containing the tier name and the perks link. |
| The customer's current tier name (e.g. "Gold"). |
| The "View perks" link (only rendered when a Link URL is set). |
| Wrapper around the progress bar and its labels. |
| The empty progress bar track. |
| The filled portion of the progress bar. |
| Row beneath the progress bar containing the requirement and target labels. |
| Text showing how much more the customer needs to reach the next tier. |
| Text showing the name of the next tier. |
Troubleshooting
The block is enabled but not showing on the storefront
Confirm the customer is logged in. Guests do not see this block.
Confirm VIP tiers are configured under Loyalty β VIP Tiers with at least one active tier.
Check that the block toggle is on and that you've clicked Save.
The link is not appearing under the progress bar
The link only appears when a Link URL is set. Add a URL and save the block.
Still need help or can't find the answers you're looking for? Reach out to the Mage Loyalty team through our live chat support.
