Skip to main content

Tier Progress Block

Show logged-in customers their current VIP tier, next tier, and progress towards it inside the Account Sidebar.

Written by Kris James

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

  1. From your Shopify admin, open the Mage Loyalty app.

  2. In the left menu, click Account Sidebar.

  3. Click the Blocks tab.

  4. Find the Tier Progress block and click on it to expand its settings.

  5. Make sure the block toggle is turned on.

  6. Fill in the Link URL and Link Text fields (see Field Reference below).

  7. 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

.mage-sidebar-tier-progress

The outer wrapper around the whole block.

.mage-sidebar-tier-progress__card

The inner card container.

.mage-sidebar-tier-progress__header

Top row containing the tier name and the perks link.

.mage-sidebar-tier-progress__tier-name

The customer's current tier name (e.g. "Gold").

.mage-sidebar-tier-progress__perks-link

The "View perks" link (only rendered when a Link URL is set).

.mage-sidebar-tier-progress__progress

Wrapper around the progress bar and its labels.

.mage-sidebar-tier-progress__track

The empty progress bar track.

.mage-sidebar-tier-progress__fill

The filled portion of the progress bar.

.mage-sidebar-tier-progress__footer

Row beneath the progress bar containing the requirement and target labels.

.mage-sidebar-tier-progress__requirement

Text showing how much more the customer needs to reach the next tier.

.mage-sidebar-tier-progress__target

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.

Did this answer your question?