Skip to main content

Loyalty program Block

Learn how to configure the Loyalty Program block in the Account Sidebar to display customers’ points balance, VIP tier, and available rewards.

Written by Kris - Mage Loyalty
Updated this week

The Loyalty Program block is the centrepiece of the Account Sidebar. It shows logged-in customers their current points balance, VIP tier, lifetime points earned, and the rewards available to them. It is the first thing most customers look for when they open the sidebar.

This block has two settings: a program title and a card style. Both affect how the loyalty information is presented to customers.

📋 Before You Start

This block displays data from your active loyalty program. Make sure your loyalty program is enabled under Loyalty in the left menu before configuring this block. If the program is not enabled, the block will have no data to display.


What the Loyalty Program Block Shows

When a logged-in customer opens the sidebar, the Loyalty Program block displays:

  • Their current points balance

  • Their VIP tier name and badge (if VIP tiers are configured)

  • Their lifetime points earned: the total points accumulated across all time

  • A View Loyalty Program link that takes customers to your loyalty landing page

  • Their available rewards: rewards they have enough points to redeem right now

ℹ️ Note

This block is only visible to logged-in customers. Customers who are not signed in will not see it in the sidebar, regardless of whether it is enabled.


How to Configure the Loyalty Program 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 Loyalty Program Settings block and click on it to expand its settings.

  5. Make sure the block toggle is turned on.

  6. Configure the settings below, then click Save.


Field Reference

Field

What It Does

Options / Example

Program Title

The heading shown at the top of the Loyalty Program block in the sidebar. Visible to logged-in customers.

e.g. "YOURSTORE LOYALTY" or "My Rewards"

Card Style

Controls how the loyalty card is displayed. Choose between Default (full card) or Compact (condensed layout).

Default or Compact


Choosing a Card Style

The Card Style setting controls how much space the loyalty card takes up in the sidebar and how the information is laid out. There are two options:

Default

Compact

Layout

Full card with prominent points balance, tier badge, and lifetime points displayed separately

Condensed single-line layout: points and tier shown together in less vertical space

Best for

Stores where loyalty is a core brand feature and you want it to feel prominent

Stores with a busy sidebar or where you prefer a more subtle loyalty display

Space used

More vertical space

Less vertical space: leaves room for other blocks

✅ Tip

Use the Preview panel on the right side of the Account Sidebar page to compare Default and Compact side by side before deciding. The best choice depends on how many other blocks you have enabled and how prominent you want the loyalty program to feel.


Naming Your Program

The Program Title field lets you give your loyalty program a branded name that appears at the top of the block. This is the first text customers see when they look at their loyalty card.

  • Keep it short, one to three words works best

  • Use your brand name to make it feel ownable — e.g. "YourStore Loyalty" rather than just "Loyalty Program"

  • Many brands use ALL CAPS for a bold, premium feel — e.g. "YOURSTORE LOYALTY"

✅ Tip

A branded program name makes your loyalty program feel like a distinct part of your brand identity rather than a generic app feature. Customers are more likely to engage with "Pitch Loyalty" than with an unnamed points balance.


Common Mistakes to Avoid

⚠️ Common Mistake

Leaving the Program Title as the default placeholder: always give your program a name that reflects your brand. A generic default title is a missed branding opportunity.

⚠️ Common Mistake

Enabling this block without an active loyalty program: if the loyalty program is not enabled under Loyalty in the left menu, the block will show but have no points data to display. Enable your loyalty program first.

⚠️ Common Mistake

Choosing Compact style with VIP tiers active: the Compact style reduces how much tier information is visible. If VIP tiers are a key part of your program, Default style gives them more prominence.


Troubleshooting

The block is enabled but showing no points data

  • Confirm your loyalty program is enabled under Loyalty in the left menu.

  • Check that the customer is logged in: this block is only visible to signed-in customers.

  • If the customer has not yet earned any points, their balance will show as zero. This is correct behaviour.

The VIP tier is not showing in the block

  • Confirm VIP tiers are configured and enabled under VIP Tiers in the left menu.

  • Check that the customer meets the points threshold for at least one tier. Customers who have not reached the first-tier threshold will not have a tier badge displayed.

The Program Title is not updating on the storefront

  • Make sure you clicked Save after editing the Program Title field.

  • Clear your browser cache or open the storefront in an incognito window to see the latest version.


Related Articles


🗨️ 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?