The Checkout Flexible Redemption block lets customers choose how many points to spend and get a matching discount, right on your checkout page. They can redeem any amount between the minimum and maximum you set, up to their points balance.
This helps customers use their points at the moment they are ready to buy, which can lift conversion and keep them coming back.
Before You Start
You need all three of these before the block will work:
Shopify Plus. Shopify only allows app blocks inside the main checkout steps on Shopify Plus stores. In the app, this block is marked with a Shopify Plus badge.
The Growth plan or higher. Checkout blocks are available on Growth and Enterprise. During a free trial of the Growth plan, the card shows Unlocks after trial. Click Contact support if you would like it unlocked sooner. On lower plans, the card shows Upgrade to Unlock.
An active Flexible amount reward. The block stays hidden at checkout until you have one.
Create a Flexible amount reward
In Mage Loyalty, go to Loyalty in the left menu.
In the Redeeming Points section, click Add Reward.
Select Discount, choose Fixed amount, then click Create reward.
Under Redemption type, select Flexible amount.
Under Conversion rate, set how much discount each point is worth.
Set the Minimum redemption and Maximum redemption. These are the fewest and most points a customer can spend on one order.
Save the reward and make sure it is active.
For more detail on the reward settings, see Discount Reward.
If you open the block settings before creating the reward, you will see a message with a Create reward button that takes you straight to the reward form.
How to Add the Block to Checkout
In Mage Loyalty, go to Loyalty Pages in the left menu.
Click the Checkout tab.
Find the Checkout Flexible Redemption card and click Set up.
Click Add to checkout at the top of the page. This opens the Shopify checkout editor in a new tab.
In the checkout editor, add an app block in the main checkout column, for example near the delivery or payment section.
Select Checkout Flexible Redemption from the list of app blocks.
Drag the block to the position you want, then click Save in the checkout editor.
When you return to the block settings in Mage Loyalty, the badge next to the name changes from Inactive to Active, and the button changes to Edit in checkout.
You can also open the checkout editor yourself from your Shopify admin under Settings > Checkout, then click Customize.
Customising the Block
Go to Loyalty Pages > Checkout > Checkout Flexible Redemption > Set up. Change the wording on the left and check it in the preview on the right. Use the Logged in and Logged out tabs above the preview to see both versions. When you are happy, click Save.
Block Content
Setting | What it does |
Title | The heading at the top of the block. |
Logged Out Message | Shown to customers who are not logged in, asking them to log in to redeem. |
Not Enough Points Message | Shown when a customer has fewer points than your minimum redemption. |
Balance Message | Shows the customer how many points they have available. |
Redeem Input Label | The label above the box where the customer types how many points to use. |
Redemption Preview Message | Shows what the customer will get for the points they typed, for example how much off. |
Redeem Button Text | The text on the button that applies the discount. |
Applied Message | Shown once the discount has been applied to the order. |
Deduction Note | Tells the customer their points will be taken when they place the order. |
Change Amount Button | Lets the customer change how many points they are using. |
Cancel Button | Lets the customer back out of changing the amount. |
Words in curly brackets, such as {points}, {min}, {max} and {amount}, are filled in automatically with the real numbers. Keep them in your text.
Behavior
Turn on Hide when no points available to hide the block completely for customers who do not have enough points to reach your minimum. When it is off, those customers see the Not Enough Points Message instead.
What Customers See
Customers who are not logged in see the title and a message asking them to log in.
Logged-in customers below your minimum see the Not Enough Points Message, or nothing if you turned on Hide when no points available.
Logged-in customers with enough points see their balance, a box to type how many points to use, a live preview of the discount, and a button to apply it.
Customers cannot redeem more than your maximum, more than their balance, or more than the order total.
Once applied, the discount shows on the order straight away. The points are only taken from their balance when they place the order, so they can change the amount or remove the discount before paying.
If your program runs in store credit mode, the block lets customers apply their store credit as a discount instead, at a fixed rate of 1 to 1. The Flexible amount reward is the only way to redeem store credit. In store credit mode, two labels change: Not Enough Points Message becomes Not Enough Credit Message, and Hide when no points available becomes Hide when no store credit available.
Common Mistakes to Avoid
Adding the block before creating a Flexible amount reward. The block stays hidden until you have an active reward with the Flexible amount redemption type. A Set amount reward does not count.
Placing the block in the order summary. On mobile, the order summary is folded away behind Show order summary, so most customers will never see it. Place the block in the main checkout column instead.
Forgetting to save in the Shopify checkout editor. Adding the block is not enough. Click Save in the checkout editor or the block will not go live.
Troubleshooting
The block is not showing on my checkout
Check you have an active reward with the Flexible amount redemption type.
Check your store is on Shopify Plus.
Open the block settings in Mage Loyalty and check the badge says Active. If it says Inactive, click Add to checkout and add the block again.
Check whether Hide when no points available is on and your test customer has fewer points than the minimum.
The block shows on desktop but not on mobile
The block is most likely inside the order summary. Open your checkout on a phone and tap Show order summary. If the block appears there, move it into the main checkout column in the checkout editor and click Save.
Customers only see a message asking them to log in
This is expected. Customers must be logged in so we can see their points balance. Once they log in, they can redeem.
A customer says they cannot enter the amount they want
They cannot go below your minimum or above your maximum redemption.
They cannot use more points than they have.
The discount cannot be larger than the order total. The block shows a message explaining which limit they hit.
The Checkout Flexible Redemption card says Upgrade to Unlock
Checkout blocks need the Growth plan or higher. Click Upgrade to Unlock to see your plan options.