Skip to main content

Customize Your VIP Tier Benefits

Build and style the VIP tier benefits section on your loyalty landing page: the header copy, the tier progress bar, and the table or cards layout. Includes how to use dynamic placeholders and conditional shortcodes.

Written by Kris James

The VIP Tier Benefits section on your loyalty landing page shows customers what each of your VIP tiers unlocks, and how close a logged-in customer is to the next tier. You can present your benefits as a comparison table or as one card per tier, write your own headings, and use dynamic placeholders so the copy speaks to each customer personally.

This guide walks through the editor in the same order it appears on screen: Header content first (titles and the progress bar), then the VIP Tier Benefits display (table or cards). Along the way it explains how placeholders and shortcodes work.

To find the editor, open your Mage Loyalty admin, go to the Loyalty Page editor, and select the VIP Tier Benefits section.


Header content

The first card in the editor controls the copy at the top of the section and the tier progress bar. It has two parts: Titles and the Progress section.

Titles

There are four title fields, split by whether the visitor is signed in. This lets you welcome members differently from first-time visitors.

Field

Who sees it

Example

Logged Out Title

Visitors who are not signed in

Exclusive VIP Tier Benefits

Logged Out Subtitle

Visitors who are not signed in

Join our VIP program and unlock exclusive rewards.

Logged In Title

Signed-in customers

Your VIP Benefits

Logged In Subtitle

Signed-in customers

You're {remaining} away from {nextTier}.

All four fields accept the dynamic placeholders and conditional shortcodes described further down.

Progress section

The progress section is a progress bar shown to signed-in customers only, above the tier benefits. It shows how far a customer has progressed toward their next tier, with their current amount and the target on either end of the bar.

  1. Show progress section: tick to display the progress bar, untick to hide it. When off, the progress bar never appears on your storefront.

  2. Progress Title: the heading above the bar (for example, Tier Status). Leave it blank to show no heading.

  3. Progress Subtitle: optional supporting line under the title. Leave it blank to hide it.

Both the Progress Title and Progress Subtitle accept placeholders and shortcodes, so you can write things like {remaining} to go until {nextTier}.


Dynamic placeholders

Placeholders are words wrapped in curly braces, like {nextTier}. On your storefront they are replaced with real values for the customer viewing the page. You can use them in any of the title, subtitle, and progress fields above.

Under the title fields in the editor you'll see the list of available placeholders. Hover any one of them to preview a sample value based on your store's VIP setup.

Placeholder

What it shows

Example

{currentTier}

The customer's current tier name

Silver

{nextTier}

The name of the next tier up

Gold

{remaining}

How much more is needed to reach the next tier

150

{progress}

The customer's current progress amount so far

350

{target}

The amount needed to reach the next tier

500

{secondary}

Remaining amount for a second entry criterion (compound tiers only)

2 more orders

How values are formatted

The number placeholders ({remaining}, {progress}, {target}) are formatted to match how your VIP tiers are earned:

  • Spend-based tiers: your store currency symbol is added automatically, for example $150.

  • Points or orders-based tiers: the value shows as a plain number, for example 150, so you can write your own unit word after it. This keeps the wording in your own voice, for example {remaining} more points, {remaining} credits, or {remaining} more orders.

The secondary placeholder

If your tiers require two things at once (for example, a spend amount and a number of orders), {secondary} fills in the remaining amount for that second requirement, already worded with its unit, such as 2 more orders or $500 in spend. You supply the connecting words yourself, for example:

Spend {remaining} more and place {secondary} to unlock {nextTier}.

If you don't use compound tiers, {secondary} simply shows nothing.

What logged-out visitors see

Visitors who are not signed in have no tier, so tier-specific placeholders like {currentTier}, {nextTier}, and {remaining} resolve to nothing. To keep that copy tidy, wrap it in the conditional shortcodes described next.


Conditional shortcodes

Shortcodes let you show different copy depending on where the customer sits in your tier ladder. They use paired opening and closing tags, and anything between the tags is only kept when the condition is met.

Shortcode

Kept when

[nextTier]...[/nextTier]

The customer still has a higher tier to reach

[maxTier]...[/maxTier]

The customer is already in your highest tier

This means a customer near the top of your program sees an encouraging "keep going" message, while a customer who has reached the top sees a congratulations message instead, all from one field.

Example

A single Logged In Subtitle can cover both situations:

[nextTier]You're {remaining} away from {nextTier}. Keep going![/nextTier][maxTier]You've reached our top tier. Enjoy every perk.[/maxTier]

Good to know:

  • Placeholders still work inside a shortcode block.

  • Both shortcodes are hidden from logged-out visitors, so tier copy never shows without a value.

  • If you mistype a tag, it is left as plain text rather than deleting your copy, so a typo can never wipe out your wording.


Choosing a layout: Table or Cards

In the VIP Tier Benefits card, use the Table / Cards toggle at the top right to choose how your benefits display. Both layouts use the same list of benefits, so you can switch between them without re-entering anything.

  • Table: a comparison grid with benefits down the side and tiers across the top. Best for showing at a glance what differs between tiers. The table will not display if it has no benefits.

  • Cards: one card per tier, listing only the benefits that tier includes. Best for a cleaner, more visual presentation.


Table layout

Tier column headers

The Tier column headers dropdown controls what appears at the top of each tier column:

  • Name only: the tier name (for example, Gold).

  • Icon only: the tier badge.

  • Icon + name: the badge above the name.

Threshold text

Under each tier name is an editable threshold line, such as Free To Join or Spend $100. It is pre-filled from the tier's threshold, and you can click the pencil icon to change the wording to whatever suits your program.

Benefit rows and cells

Each row is a benefit. For every tier column you choose how that benefit appears using the small control in the cell:

Control

Meaning

Included in this tier

Not included in this tier

Aa

Custom text, for example 1.5x or 100 points

To manage the list of benefits:

  1. Add a benefit: click + Add benefit, type a name, and click Add.

  2. Rename: hover a row and click the pencil icon.

  3. Remove: hover a row and click the trash icon.

  4. Reorder: drag a row by its handle on the left. The order you set is the order customers see.


Cards layout

In Cards layout each tier becomes its own card that shows only the benefits that tier includes. You control what appears on each card.

Card style

Use the Card style toggle to choose how the top of each card looks:

  • Banner: a hero panel at the top of the card. Upload a Banner image per tier, and optionally set a Header color that fills the panel when no image is set.

  • Icon: the tier badge (your custom badge image, or the tier's color with a Roman numeral). A Header color colors the band behind the icon, name, and threshold.

Featured benefit

Each card has an optional Featured benefit field, a prominent line shown above the perks, for example 10% back in points. Use it to lead with the tier's headline perk.

In this field, wrapping text in curly braces makes it stand out visually. For example, {10%} back in points emphasizes "10%".

Note: curly braces in the Featured benefit field are for visual emphasis only. They are not data placeholders. Dynamic placeholders like {nextTier} only work in the title, subtitle, and progress fields.

Threshold text

Just like the table, each card has an editable threshold line under the tier name (for example, Spend $100). Click the pencil icon to change it.

Perks

Perks are the same shared list of benefits used by the table. On a card, each perk row has a control:

Control

Meaning

Included on this card

Remove this perk from this card only

  1. Add a perk: click Add perk on a card and type a name. Typing a name that already exists reuses that benefit, so the same perk can appear on more than one card.

  2. Remove from this card: set the perk to ✗. It stays available to add elsewhere.

  3. Remove from every card: click the trash icon. This deletes the perk from the shared list.

  4. Reorder: drag a perk by its handle. The order is shared across every card that includes it.


Saving and going live

When you make changes, a save bar appears at the top of the editor.

  1. Save: click Save to store your changes. You'll see a confirmation once it's saved.

  2. Discard: click Discard to undo unsaved changes and return to the last saved version.

Make sure the VIP Tier Benefits block is added to your loyalty page so customers can see it. Your saved content, layout, and copy then appear automatically on the storefront.

You can also run a header-only or progress-only section: if you leave the benefits list empty, the table or cards are hidden and only your titles and progress bar show.


Copy-paste examples

Logged Out Subtitle (points-based program):

Join our VIP program and start earning toward exclusive rewards.

Logged In Subtitle (handles both mid-program and top tier):

[nextTier]You're {remaining} more points from {nextTier}. Almost there![/nextTier][maxTier]You've reached {currentTier}, our top tier. Thank you![/maxTier]

Progress Subtitle (spend-based program):

You've reached {progress} of the {target} needed for {nextTier}.

If you'd like a hand setting up your VIP tier benefits, reach out to our support team and we'll be glad to help.

Did this answer your question?