Minimum XP Spend

Set minimum XP spend requirements on individual products to gate certain items for your most loyal customers. To buy one of these products, a customer has to apply at least that much XP to their order. To see how customers apply XP on your store, see How to Use Your XP.

Note

This feature requires a connected Shopify store. If you haven’t set up your integration yet, start with the Shopify Integration guide.

1. Add the XPN Min XP Spend Block

   Go to any product in your Shopify Admin > Products and scroll down to the Blocks section. Add the XPN Min XP Spend block to the product page.

2. Set the Minimum XP Requirement

   Enter the minimum XP required to purchase the product in Minimum XP Spend, then select Save XP Spend Settings. Leave the field empty or at 0 for no minimum.

   

   If the product has more than one variant, select Set variant-specific minimums to give a variant its own minimum, or Clear all overrides to go back to the product’s minimum, then select Save XP Spend Settings. A variant set to 0 or left empty uses the product’s minimum, so to sell one variant without a minimum, leave the product’s Minimum XP Spend empty and set minimums only on the variants that need them.

3. Enable Checkout Validation

   For minimum XP requirements to be enforced at checkout, you must turn on the checkout rule:

   • Go to Settings > Checkout in your Shopify Admin
   • Scroll down to the Checkout rules section and select Add rule
   • Choose XPN Minimum XP Spend Validation
   • Select Save, then Turn on

   The rule is now active for all checkouts. Customers can add these products to their cart freely, but if they haven’t applied enough XP to their order, they’ll see an error message at checkout and won’t be able to complete the purchase until they apply more.

   

4. Display Minimum XP on Your Storefront

   You can add a theme block that shows customers the minimum XP needed to purchase a product directly on the product page.

   • Go to Online Store > Themes in your Shopify Admin
   • Select Customize on your active theme
   • Navigate to your product page template
   • Select Add block where you want it to appear, and choose XP Minimum Spend Badge
   • Select Save

   

   The badge shows “Requires N XP minimum” on products that have a minimum, with “XP” replaced by the Points Title set on your XP Network Login block, and stays hidden on products that don’t. Customers can select the badge to sign in with XP Network. Once signed in, they also see “You have enough XP” or “You need more XP” based on their balance. You can change the badge’s style, icon, colors, font size, and margins in the block settings.

   Note

   The badge needs the XP Network Login block from your theme setup. Without it, the badge shows “XP” instead of your Points Title, and customers can’t sign in from the badge or see whether they have enough XP.

   

How Minimum XP Works

Level	Behavior
Product-level	Sets a default minimum for all variants
Variant-level	Overrides the product-level minimum for specific variants
Additive	The minimum is multiplied by quantity and added up across the cart. For example, 3 of a 100 XP product plus 1 of a 200 XP product requires 500 XP.

Things to Keep in Mind

• Customers can’t apply more XP than their balance or the value of their cart. If a product’s minimum is higher than its price in XP, customers can only meet it by adding other items to their cart.
• If your XP discount only applies to Specific collections, make sure products with a minimum are in those collections. Otherwise customers can’t apply enough XP to buy them. See Set Up Discount Configuration.
• Applied XP is cleared if a customer comes back to their cart more than 10 minutes after applying it, and it doesn’t go up when they add more of a product with a minimum. Customers may need to apply XP again before checking out.