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 over a month ago

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.

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.

ℹ️ Note

This is a required block. 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 and expand it.

  5. Configure the settings below and 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.

Default or Compact


Choosing a Card Style

  • Default: full card with prominent points balance, tier badge, and lifetime points displayed separately. Best when loyalty is a core brand feature.

  • Compact: condensed single-line layout. Best for stores with a busy sidebar or a more subtle loyalty display.

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"


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: 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?