Skip to content
POINTS & TIERS GUIDE

Turn point milestones into automatic tier upgrades

Define how members move from Bronze to Silver, Gold, and open-ended Platinum tiers on one template — automatically swapping pass colors, artwork, and Tier reached lock-screen notifications.

Dynamic colors & artwork per tier
Contiguous threshold & gap checks
WCAG AA/AAA readability badges
Custom Tier reached push alerts
Interactive Tier Simulator
Progression MapTop tier is open-ended
Member points240 pts
LOYALTY CARD · GOLD (Apple Wallet)
LOYALTY CARD · GOLD
Apple#D1972D

Burnished Gold Emblem

260 pts until Platinum (500+ pts)

Tier reached push message preview

Congratulations! Your tier has been updated to Gold.

WHY LOYALTY PROGRESSION RULES ARE NEEDED

Why rule-driven tiers beat static loyalty templates

A points balance alone rarely communicates status. Loyalty progression rules bind point thresholds directly to visual wallet pass themes, required asset checks, and real-time upgrade notifications.

01

Members cannot see or feel status progress on static cards

When a digital loyalty card looks identical at 0 points and 500 points, loyal buyers miss tier milestones unless staff check a CRM screen manually.

02

Managing separate templates per status creates operational drift

Without rule-driven tiers on one template, teams duplicate pass templates for Silver, Gold, and Platinum — causing broken barcodes, manual re-issuance, and inconsistent design updates.

03

Gaps, low contrast, or missing tier assets break live pass updates

Unvalidated threshold gaps, illegible color combinations, or missing Apple/Google tier artwork cause awkward wallet states when a customer crosses a point milestone.

Without progression rules
  • Static template colors and strip graphics stay unchanged as members earn points
  • Duplicate templates per status split pass editions, fields, and barcode tracking
  • Manual status checks leave customers guessing when they reach the next tier
With Loyalty progression rules
  • Automatically swaps tier colors, logos, and artwork from one template when points cross a threshold
  • Validates threshold overlaps, progression gaps, WCAG contrast ratios, and missing wallet images before publish
  • Sends custom Tier reached push notifications on Apple Wallet and Google Wallet transitions

HOW TIER EVALUATION WORKS

Four coordinated bands from first scan to Platinum

Every tier inherits your core template layout while overriding points bounds, pass palette, Wallet artwork, and milestone messaging.

Bronze0-99 pts

Warm Espresso & Bronze Foil

“Welcome to Bronze! Collect 100 pts to unlock Silver status.”

7.74:1 AAA · 15.31:1 AAA01
Silver100-199 pts

Brushed Chrome Metallic

“Congratulations! Your tier has been updated to Silver.”

High Contrast Silver Theme02
Gold200-499 pts

Burnished Gold Emblem

“Congratulations! Your tier has been updated to Gold.”

Golden Warmth Theme03
Platinum500+ pts

Dark Titanium Finish

“Congratulations! Welcome to Platinum — our highest loyalty tier.”

Open-ended Top Tier04

HOW TO CONFIGURE & USE

How to configure Loyalty progression rules inside Studio

Follow these six steps inside Template settings -> Points & Tiers to set ranges, test contrast and artwork, and automate wallet pass upgrades.

01

Select Points & Tiers in Program rules

In Passinstance Studio, open Template settings -> Points & Tiers to load the Loyalty progression rules canvas and rule summary bar (Tiered progression -> Point accumulation -> Tier upgrade).

02

Configure Progress settings and defaults

Set Progress range (Starts at and Ends at point boundaries) alongside Default progress (New member starts with e.g. 0 pts, and Default increment e.g. 100 pts used during scans).

03

Build and preview tiers on the Progression map

Review the color-coded Progression map (0-99, 100-199, 200-499, 500+ pts). Hover any row or map block to preview its live Wallet pass design; click + Add tier to append the next level automatically.

04

Edit Threshold, Maximum Value & Tier reached message

Open a tier to edit its Tier name, Threshold (PTS), and Maximum Value (leave blank for an open-ended top tier). Write a custom Tier reached message up to 500 characters using {variable} placeholders.

05

Verify WCAG Theme contrast & Wallet images

Pick Label text color, Value text color, and Background color with live WCAG AA/AAA contrast ratings, then upload required Logo and Google Wallet logo (660 x 660 px) assets so no tier stays flagged NEEDS REVIEW.

06

Resolve range warnings, publish & award points

Clear any Progression gaps detected banner, publish your draft template, and update balances via Scanner, Automations, or REST API — Passinstance handles live wallet upgrades automatically.

INSIDE PASSINSTANCE STUDIO

Annotated walkthrough of the Progression Map & Tier Editor

1 / 5
Dashboard view1 / 5
Key UI elements

Loyalty progression overview — Bronze tier (0–99 pts) & Progress settings

Inspect the GOAL/TRIGGER/AFFECTED/RESULT strip, full Progression map (0-99 to 500+ pts), tier rows with mini theme thumbnails, and baseline Progress settings in one view.

STUDIO CONTROLS & GUARDRAILS

Range guardrails, accessibility checks & automatic wallet updates

Studio validates configuration before publishing, while the API keeps issued Apple Wallet and Google Wallet passes synchronized across every point update.

Visual Bar + Hover Preview

Progression map & live wallet hover

Displays every loyalty band proportionally across your program and switches the right-hand Live preview pane when you hover over Bronze, Silver, Gold, or Platinum.

Open-Ended or Bounded

Contiguous thresholds & gap guardrails

Studio blocks overlapping ranges or negative bounds and surfaces a Progression gaps detected banner if points could fall between tiers. Leave Maximum Value blank on the final tier for an open-ended cap (e.g. 500+ pts).

Starts at · Ends at · Increment

Progress range & default increment

Starts at and Ends at define overall program bounds (scanned point additions cap cleanly at Ends at), while New member starts with and Default increment control initial balance and default scan delta.

Live AA / AAA Ratio

WCAG-checked palette & Apple RGB serialization

Shows real-time contrast badges (such as 7.74:1 AAA and 15.31:1 AAA) against the tier background so pass fields remain readable and serialize reliably to Apple Wallet rgb(r, g, b) values.

Apple + Google Slots

Per-tier Wallet images & NEEDS REVIEW checks

Tracks required assets (Logo, Google Wallet logo 660 x 660 px) and optional tier background or Android overrides. Required-slot banners highlight missing artwork via Upload missing.

500 chars + {placeholders}

Tier reached message & push dispatch

Supports {variable} autocomplete (up to 500 characters) for custom milestone alerts. Leave blank to use the built-in upgrade message when Passinstance pushes Apple APNs or Google Wallet updates.

RUNTIME UPGRADE TRIGGERS

When Passinstance re-evaluates a member's tier

SCAN

Staff scan or check-in

Passinstance Scanner adds points (or uses Default increment), clamps within Ends at, and immediately evaluates the next qualifying tier.

WEBHOOK

Commerce & Automation events

Verified order-paid webhooks, Shopify/Shopware sync, or Workflow-Engine rules award points and emit tier.upgraded events.

MANUAL

Dashboard pass adjustments

Support staff adjusting a holder's balance in the dashboard immediately recalculate and sync tier colors and imagery.

SCHEDULED

Batch & scheduled updates

Bulk CSV imports or scheduled loyalty recalculations update qualifying passes in bounded batches with idempotent theme resolution.

FAQ

Frequently asked questions about Loyalty progression rules

How does Passinstance decide which tier a member belongs to?

When a pass balance updates, the backend sorts tiers ascending by Threshold (minValue) using exact Decimal math and selects the highest qualifying tier whose minValue <= storedValue <= maxValue (or unbounded when Maximum Value is blank).

What happens if two tier ranges overlap or leave a gap?

Studio blocks saving overlapping ranges directly in the tier editor and alerts you with a 'Progression gaps detected' banner on the tier list if integers are skipped between consecutive ranges.

Do I have to upload every image separately for every tier?

Required brand slots (such as Logo and Google Wallet logo when Google Wallet is enabled) are tracked per tier with a NEEDS REVIEW check, while optional tier background or Android overrides fall back cleanly to your base template artwork when left unset.

What notification is sent when a member changes tiers?

If you fill in Tier reached message (with optional {variable} placeholders), that copy is sent on transition. Otherwise Passinstance sends 'Congratulations! Your tier has been updated to {tier}.' on upward promotions or 'Your tier has been updated to {tier}.' if points drop into a lower band.

Build tiered wallet loyalty without duplicate templates

Configure your Progression Map, verify WCAG contrast and Wallet images in Studio, and automate live Apple Wallet and Google Wallet upgrades.