Skip to main content
Tier structures control how you assign customers to tiers and how their tier status changes over time.

​
Create a tier structure

Go to Loyalty hub > Tier structures and select Create tier structure. The tier structure builder informs which steps require your action.
1

​
General settings

Set the basic behavior of the tier structure.Name tier structure: enter a name for the structure.
Uses the customer’s current point balance on their loyalty card to determine tier assignment.
Point wallet: Select the point wallet used to calculate tiers.
Tying a tier structure to a point wallet that is already active makes the tier structure take effect immediately.A loyalty program can only have one tier structure assigned to it.
Complete all required fields. If something is missing or invalid, you will see Action required.
2

​
Tier levels point-base

Configure tier levels based on the point balance.This tier level path is optional. Set it up only if you want tiers based purely on point balance. At least one tier must exist across the two tier-level paths (point-based or segment-based) before you can proceed. Any path you configure must cover points without overlaps. However, gaps between tiers are allowed and a final tier with a maximum value instead of unlimited.Tier levels are shared with the segment-based path. Both count toward the same 100-tier limit. Each tier you create only appears in the path it was created under. A tier added here won’t appear in Tier levels segment-base, and vice versa.Use + Add tier levels to add a tier.For each tier, define:
  • Tier name: Label of the tier (for example Bronze, Silver, Gold).
  • Minimum value (points): Points required to reach this tier. When you add a new tier, this is automatically set to one point higher than the previous tier’s Maximum value (points). You can adjust it manually, though.
  • Maximum value (points): Upper limit of points for this tier. Leave this field empty to make the tier Unlimited. This is only allowed for the highest tier; leaving it empty on any other tier triggers the Action required mentioned above.
  • Allow tier downgrade for this level: Enabled by default. Uncheck to create a VIP tier where members keep their level forever.
  • Point expiration: Select the point expiration settings for this tier.
    • Inherit from wallet: The point expiration is inherited from the point wallet configuration.
    • Override expiration: Set custom point expiration for this tier. If the point wallet expiration is set to No expiration, the tier point expiration can be set to any setting (Immediate expiration, Rolling expiration, Calendar expiration, Sliding expiration). The points that members earn while in this tier will expire as set. However, if the point wallet expiration setting is not set to No expiration, the tier point expiration has to match the point wallet expiration setting or it has to be set to No expiration. It can have different details, like different duration or dates, though.
The tier’s point range is calculated automatically from its Minimum and Maximum values and shown in the tier’s header.Each tier also has its own Metadata section, where you can define custom key/type/value properties, either by adding an unknown property directly or by adding it to the schema.
3

​
Tier levels segment-base

Configure tier levels that also require a customer segment, a group of customers who share a selected attribute or behavior.This path is optional. Set it up only if you want segment-gated tiers. At least one tier must exist across the two tier-level paths (point-based or segment-based) before you can proceed. Any path you configure must cover points without overlaps. However, gaps between tiers are allowed and a final tier with a maximum value instead of unlimited.Tier levels are shared with the point-based path. Both count toward the same 10-tier limit, and each tier you create only appears in the path it was created under. A tier added here won’t appear in Tier levels point-base, and vice versa.Use + Add tier levels to add a tier.For each tier, define:
  • Tier name: Label of the tier (for example Bronze, Silver, Gold)
  • Minimum value (points): Points required to reach this tier. When you add a new tier, this is automatically set to one point higher than the previous tier’s Maximum value (points). You can adjust it manually, though.
  • Maximum value (points): Upper limit of points for this tier. Leave this field empty to make the tier Unlimited. This is only allowed for the highest tier; leaving it empty on any other tier triggers the Action required mentioned above.
  • Customer segment: Required for every tier in this path. The customer must meet both the point range and belong to the selected segment. You can select different segments for each tier.
  • Allow tier downgrade for this level: Enabled by default. Uncheck to create a VIP tier where members keep their level forever.
  • Point expiration: Select the point expiration settings for this tier.
    • Inherit from wallet: The point expiration is inherited from the point wallet configuration.
    • Override expiration: Set custom point expiration for this tier. If the point wallet expiration is set to No expiration, the tier point expiration can be set to any setting (Immediate expiration, Rolling expiration, Calendar expiration, Sliding expiration). The points that members earn while in this tier will expire as set. However, if the point wallet expiration setting is not set to No expiration, the tier point expiration has to match the point wallet expiration setting or it has to be set to No expiration. It can have different details, like different duration or dates, though.
The tier’s point range is calculated automatically from its Minimum and Maximum values and shown in the tier’s header.Each tier also has its own Metadata section, where you can define custom key/type/value properties, either by adding an unknown property directly or by adding it to the schema.
4

​
Tier expiration

Choose how a tier expires.
Tier ends instantly when member criteria changes.

​
Tier downgrade configuration

Choose how tier levels are reassessed when a member no longer qualifies.
Members keep their current tier when expiration triggers or they no longer qualify for the current tier. This means that members never move to a lower tier.
Expiration and downgrade are configured independently. Expiration controls when tier levels are re-evaluated. Downgrade controls how members move to a lower tier after expiration.
5

​
Metadata

Add custom attributes for tracking, optimizing, or experimenting.You can either:
  • Use an existing metadata schema.
  • Add unknown property: Metadata that isn’t defined and won’t be added to the schema.
  • Add to schema: Define new metadata schema. Once saved, reload the schema to use the new metadata.
Read Metadata to learn more about custom attributes.
6

​
Summary

Review your configuration before saving.The summary lists a card for each step, showing condensed details of your configuration. Use Go to step on any card to return to that section and make changes.Save draft and Save and activate both become available only once there’s no outstanding Action required anywhere in the configuration. Save draft saves the structure without activating it. Save and activate saves it and activates it immediately. Once activated, you can’t edit the tier structure and its tiers with the exception of name and metadata.
The tier structure is now created and can be used in a loyalty program.

​
Tier structures view

The Tier structures view lists all configurations created in your project. Each structure appears with its status and key settings.

​
Overview

This list shows key details of each tier structure.
  • Status: Draft (not yet activated) or Active.
  • Name: Name of the tier structure.
  • Type: The tier type configured in General settings.
  • Point wallet: The wallet the structure is linked to.
  • Expiration: The expiration model configured in Tier expiration, shown as a short label (for example Calendar for Calendar Expiry), or a dash if none is set.
  • Downgrade: The downgrade behavior configured in Tier downgrade configuration, or a dash if none is set.
  • Tier levels: Number of defined tiers, or a dash if none are configured.
  • Loyalty programs: Programs where the structure is assigned, or a dash if none.
Use Edit or Delete from the ⋮ menu on any row to manage a structure.

​
Structure details

Select a structure name to open its details panel. The panel header shows the structure’s ID, creation date, and status, along with Edit and close controls. If the structure is in Draft status, an Activate button also appears; activating it makes it available to be assigned to a point wallet, and if that point wallet is already active, tier assignments can start applying immediately.
Once a structure is Active, it cannot be deactivated in the UI or through the API.
The panel has three tabs:
  • Dashboard: Summary cards for General settings, Tier levels, and Tier expiration (which also includes the downgrade configuration).
  • Activity: A log of events for the structure, such as its creation and tier creation events.
  • Metadata: The structure’s metadata, shown as raw JSON.

​
Using tier structures in programs

Assign a tier structure to a point wallet from within the program Designer.

​
Adding a tier structure

Each point wallet card shows a No tier structure assigned placeholder if none is set. Selecting it opens a search field where you can pick an existing tier structure or select + Create new to create one on the spot. You can assign only one tier structure per program. If another point wallet in the same program already has one assigned, you’ll see a message telling you to unassign it there first.

​
How it appears in the program

Once assigned, the point wallet card shows the structure’s name, status, a condensed summary (type, expiration, downgrade, and tier level count), and its configured tiers.

​
Removing a tier structure

Select Unassign from program next to the assigned structure on the wallet card. This only removes the assignment; to delete the tier structure itself, go to the Tier structures overview list.
Once a tier structure is assigned to an active point wallet in an active loyalty program, it cannot be unassigned.
Tier structures can be used together with the following features to build more advanced loyalty program flows.
Learn how to create and manage customer segments to define groups of customers who share a selected attribute or behavior.Customer segments can be used to create tier-based loyalty programs, limit earnings to specific segments, or create segment-based rewards.
Last modified on August 6, 2026