FAQ
Frequently Asked Questions
Welcome to Regios Automatic Discounts. Here are answers to the most common questions we receive.
We encourage you to use CTRL+F (or Command+F) to search this page.
Help! My discounts don't work.
Please read our Troubleshooting Regios Automatic Discounts article to solve your problem.
How can I combine/stack my discount with other discounts?
A screenshot of the "Combinations" options (https://storage.crisp.chat/uPopularCapabilities of Regios Automatic Discounts
The 1 automatic discount app
Regios Automatic Discounts is a Shopify app released in 2023 to help merchants create advanced, segmented, discount offers on their store.
It is compatible with many other apps, and was awarded the Built for Shopify badge for its high quality.
You can create both automatic discounts and manual discount codes.
Key Features
Dynamic Discounting
Our app automaticallSome readersAutomatic Discounts Pricing FAQ
Welcome to Regios Automatic Discounts. Here are answers to the most common pricing questions we receive.
We encourage you to use CTRL+F (or Command+F) to search this page.
How can I upgrade/downgrade my plan?
Screenshot of the "Choose Plan" link in the Regios Discounts navigation.
In Regios Automatic Discounts, select "Choose Plan" to be taken to our billing page.
Screenshot of the billing pageFew readersSubscription App Compatibility with Regios Automatic Discounts
General rules for compatibility
Our app's discounts work basically the same as Shopify's automatic discounts. In general, anything that is compatible with those, will be compatible with our app.
If a subscription app uses Shopify's Subscription API, it will likely be compatible with our app.
If a subscription relies on draft orders, it will likely not be compatible with our app.
Known supported subscription apps
These are subscription apps other customers have told us work with ourFew readersHow to Duplicate Discounts
Making duplicates of existing discounts can be done in few steps, these steps are described in two parts;
Part 1 - Export Logic
On your existing discount page, at the top right, locate the “Logic” button, Click it
Screenshot of the Logic button when clicked
Click “Export”, and you’ll be prompted with your browser file download interface. Download the JSON file.
Part 2 - Import Logic
On your duplicFew readersApplying Discounts Once Per Customer
In Shopify, it is impossible to create an automatic discount that applies only once per customer.
There are 3 alternative options you can use to work around this:
Create a discount code instead
Base the discount on the customer's number of orders
Use Shopify Flow to automatically tag customers who have used the discount
Option 1: Create a discount code instead
Screenshot of "Maximum discount uses" options (https://storage.crisp.chat/users/helpdesk/website/d13e90de659a8800/imageFew readers
Troubleshooting
Troubleshooting Regios Automatic Discounts
We're sorry you're experiencing problems with our app. In this article, we've outlined how to handle the most common problems users face with our app.
We encourage you to use CTRL+F (or Command+F) to search this page.
Troubleshooting discounts on product pages
If you're using the "Product page discount" app block/"Discounts embed" app embed:
Consult this article for help.
If you're using the "Discounted price" app bloPopular5 App-Based Discounts Error
Screenshot of the "5 total app-based discounts" error message
Unfortunately, Shopify has a limit of 5 app-based discounts at a time.
This applies to ALL apps on your entire store combined, not just ours.
If you are using any other apps that created Shopify Functions discounts, they are included in the total.
What is an "app-based discount"?
Our app is built on a new Shopify feature called ShopifySome readersTroubleshooting Discounts on Product Pages
TO READ THE TROUBLESHOOTING GUIDE FOR THE "DISCOUNTED PRICE" APP BLOCK, CLICK HERE.
We encourage you to use CTRL+F (or Command+F) to search this page.
We strongly encourage you to try all of the steps outlined in this guide.
Skipping steps may mean waiting for a solution from us in cases where your problem could have been resolved immediately.
First - Check The Developer Tools Console
A screenshot of console lFew readersMy Discount Stops Working When There Are Many Items In The Cart!
Are you noticing your discount stop working when a certain number of items are in the cart? Or are you seeing your discount only apply in the cart/checkout sometimes?
The problem you're facing is because Shopify Functions, where our app runs code on Shopify's servers, has strict limits on how much it can handle at once. This is why your discounts aren't applying correctly when the cart gets full.
Workarounds
You could try setting up more discounts, where each one has fewer conditions. ThisFew readersTroubleshooting the "Discounted Price" block
We're sorry you're experiencing problems with our "Discounted price" app block. In this article, we've outlined how to handle the most common problems users face with this feature.
We encourage you to use CTRL+F (or Command+F) to search this page.
"There is a problem with the app block"
Screenshot of how this error message appears in the Theme Editor.
Your theme might not be compatible.
Please maFew readersYour Discount Configuration Is Too Big Error
Screenshot of the "Your discount configuration is too big" error message
Unfortunately, Shopify Functions limits the size of metafields, which we use to store your discount configuration, to 10 kilobytes.
If you're reading this, then your discount configuration data is currently bigger than 10 kilobytes.
What is a "discount configuration"?
OurFew readersPOS Custom Sales and Regios Automatic Discounts
Unfortunately, due to limitations in Shopify itself that we cannot work around, our app is incompatible with custom sales in the POS.
Background information
Our app's discounts are built using a Shopify API called Shopify Functions.
This means that the discounts you create in our app are calculated on Shopify's servers, and for the most part, they work like Shopify's built-in discounts.
However, there are some subtle, undocumented differences between Shopify Functions discounts, and ShopifFew readersMy Discount Isn't Applying In The Cart/Checkout
There are a few different reasons you might not be seeing your discount applying.
The easiest way to troubleshoot - use the "Test discounts" page
"Test discounts" page tutorial video thumbnail
We have created a "Test discounts" page in our app, that lets you:
Preview how discounts will apply with different items in the cart, different customeFew readersHelp! The Discounted Prices Are Displaying To Everyone!
THIS DOCUMENT IS FOR THE "DISCOUNTED PRICE" BLOCK. FOR INFORMATION ABOUT THE NEW VERSION OF THE "DISCOUNT ON PRODUCT PAGE" (DOPP) FEATURE, CLICK HERE.
There are a few possible reasons why your "Discounted Price" block might appear to be offering discounted prices to everyone.
Possibility 1 - You don't have Visibility settings enabled
Screenshot of the "Visiibility" settings (https://storage.crisp.chat/users/helpdesk/wFew readersThe Calculated Discount Is Incorrect!
There are a few different reasons you might be seeing an incorrect discount applying:
The easiest way to troubleshoot - use the "Test discounts" page
"Test discounts" page tutorial video thumbnail
We have created a "Test discounts" page in our app, that lets you:
Preview how discounts will apply with different items in the cart, different custFew readersTroubleshooting Custom Theme Setup
If you are experiencing issues with custom theme setup, please try the instructions in this article to resolve your issue.
We strongly encourage you to try all of the steps outlined in this guide.
Skipping steps may mean waiting for a solution from us in cases where your problem could have been resolved immediately.
First - Check The Developer Tools Console
A screenshot of console logs identifying common setup errors (https://storage.crisp.chat/users/helpdesk/website/d13e90de659a8800/Few readersIncompatible Apps
Regios Automatic Discounts works basically the same as Shopify's built-in automatic discounts, ensuring compatibility with most other Shopify apps that function similarly. However, there are certain Shopify apps that our app is not compatible with. These include:
Giftship
Our app is not compatible with Giftship. Giftship has a different implementation of the cart and checkout page, which prevents the discounts created in our app from displaying correctly.
Globo
We're aware that our app mFew readersExtensible Discounts Error
Screenshot of the "extensible discounts" error message
In this article, we address the "Extensible Discounts" error message that some users encounter, specifically those with Shopify Plus or legacy stores. This guide provides clear instructions and solutions for users experiencing issues with discount functionality.
Common Use Cases
Receiving the "Extensible Discounts" error on Shopify Plus stores witFew readersShopify Functions Input Query Complexity Limitation
This article explains why:
Some feature requests cannot be implemented
Shipping discounts do not support certain features, such as the "Logged-in customers" customer eligibility option
What is the "input query complexity limitation"?
Our app is built on a new Shopify feature called Shopify Functions. Discounts built with Shopify Functions execute their code on Shopify's servers, instead of our own servers. However, this comes with several limitaFew readersFunction Not Found Error
Screenshot of the "Function Not Found" error
If you are getting a "Function not found" error, it's possible a new version of our app's Shopify Functions went live while you were in the process of creating your discount.
This rarely happens, but if so, follow these instructions:
1. Backup your discount logic, so you don't lose it
Screenshot of the "Import" and "Export" buttons (https://storage.crisp.chFew readersActive Period Overlap Error
Usually, when people run into this error message, it is due to one of the following causes:
You have more than five app-based discounts in your store. The article we linked goes into detail about this issue and its workarounds.
You have an active built-in Shopify automatic discount (these prevent other automatic discounts from being active at the same time). If so, temporarily deactivate it, then save again. See the following section forFew readers500 Internal Server Error
Screenshot of the "500 Internal Server Error" error
If you are getting a "500 Internal Server Error" error, it's hard to tell at first glance what the cause could be. Some possible causes include:
A bug in our app's backend
An outage or breakage on Shopify's end
In this case, the most important thing is to prevent losing your work. Follow these instructions to save your discount until the issue is resFew readers
Examples
Logic Builder: Examples
We've created special video and text tutorials to guide you on creating common types of discounts using our advanced logic builder.
We hope that these brief videos will help you create the exact offer you wanted, quickly.
How To Apply An Automatic Discount for Customers with a Specific Tag
Screenshot of a discount for customers with a specific tagSome readersHow to Create Bundle Discounts
Bundles are a common type of discount, mainly used to incentivize large orders. You can use Regios Automatic Discounts to create bundle offers; however, our app does not currently have a way to display bundle offers on product pages.
Examples
Buy 1 camera and 1 lens, get 20% off both the camera and the lens
Buy 1 table and 4 chairs, get 10% off the table and chairs
General Approach
To create bundles in our app, you need to understand the logic. Typically, a bundle is like a discountFew readersHow to Create Discounts for Product Tags
Unfortunately, our app's product eligibility options do not include product tags.
Want us to add this?
If you'd like us to add support for product tags, please upvote and comment on this thread in our public feedback board.
We prioritize which features to add to our app based on the number of upvotes.
Workaround
ScreenshotFew readersHow to Exclude Products or Customers from a Discount
Sometimes, you want a discount to only apply to customers without a specific tag, or products that are not in a specific collection.
Using our advanced logic builder, you can create conditions that exclude specific customers or products from being considered eligible for a discount.
Example Use Cases
A 20% off discount for DTC customers only, but not B2B customers
A discount that applies to your entire catalog, except for used itemFew readersHow to Create Buy X Get Y Discounts
Sometimes, you want to offer customers a special promotion where buying one product unlocks a discount on another.
Using our advanced logic builder, you can create a Buy X Get Y discount easily.
Example: With Quantity (Recommended)
Screenshot of Buy X Get Y Get Discount With Quantity
Create a new "Include/exclude products" condition. Add yourFew readersHow to Set a Maximum Discount Amount Per Order
Sometimes, in order to protect your margins, you'll want to set a maximum discount amount per order. Using our advanced logic builder, it's easy to set this up.
All you need to do is create a discount that:
If the subtotal of eligible products is greater than or equal to your maximum discount amount, divided by the desired discount percentage
Otherwise, apply a fixed amount discount.
Example Use Cases
A 60% discount based on a tag, up to $200 value of an order? You'll need a discountFew readers
Discounts on Product Pages
Supported Themes
Because every Shopify theme is different, our "discounted price on product page" (DOPP) feature only has dedicated integrations with a limited number of themes out of the box.
Other themes can still be used, with some additional setup.
This article will explain how to make sure you can display discounted prices on product pages in any theme, and ideally support collection pages as well.
Which themes are supported out of the box?
Dawn (and any theme based on it, we have a list below)
CePopularHow to Display Discounts on Product Pages
TO READ THE DOCS FOR THE "DISCOUNTED PRICE" APP BLOCK, CLICK HERE.
Thumbnail of tutorial video
Click the thumbnail above to watch a video of our founder demonstrating how to set up this feature.
You can improve customer experience by displaying discounted prices on product pages, collection paPopularCustom Theme Setup
Need help?
We have created a Troubleshooting Custom Theme Setup article to help you resolve the most common problems quickly.
Custom Theme Setup Guide
Custom theme setup intro video thumbnail
Click the thumbnail above to watch an introductorySome readersDOPP API Reference
You can enhance customer experience by integrating Regios Automatic Discounts deeply with your theme.
To do this, use the DOPP (discount on product page) API. It's a combination of event listeners (which you can fire to trigger updates to our app blocks), and public objects/functions (which you can use to handle the results of calculations yourself).
Public API TypeScript Definition
We highly recommend using TypeScript when working with the API.
You can paste this TypeScript definition (htSome readersDiscount Description Templates
TO READ THE DOCS FOR THE "DISCOUNTED PRICE" APP BLOCK, CLICK HERE.
Tutorial video thumbnail
Click the thumbnail above to watch our founder explain how to set up discount description templates.
Screenshot of the default discount description template (https://storage.crisp.chat/users/helpdesk/wFew readersUsing the Discounted Price Block With Product Page Discount
Tutorial video thumbnail
Click the thumbnail below to watch a 2-minute demo of this setup.
To display automatic discounts on product pages only, you can simply use our existing "Discounted price" app block.
It can optionally replace Shopify's built-in "Price" block on your product page.
It is already set up to be compatible with the "ProductFew readersLimitations of the Discounted Price Block
The "Discounted price" block has several limitations:
The app block HTML is based on the Dawn theme. If you are on another theme, you may have to customize the CSS. We have included some styles that support a wide array of themes, but some may slip through the cracks.
Automatically changing the on-page price when a variant is selected is only fully supported in Dawn. We have some code for this that supports a wide array of themes, but some mayFew readersSetting Up Multiple Collection Page Discount Blocks Per Page
If you have multiple collections displayed on a specific page (for example, multiple featured collections on your home page), then you need to perform special steps to set that up.
The objective of this process is to set up multiple collection page discount blocks per page in your theme by adding unique keys to each collection grid to enable the app to identify and display discounts correctly.
Tutorial video thumbnail (https://storage.crisp.chat/users/helpdesk/website/d13e90de659a8800/imageFew readersUsing Multiple Discounted Price Blocks At The Same Time
If you have multiple discount offers you would like to display on product pages, then you will need to add the "Discounted price" block to your product page template multiple times.
Screenshot of 2 "Discounted price" blocks in the same template
For example, if you have a 10% off products discount for your "Silver" tagged customers, and 20% off for your "Gold"Few readersVolume Pricing Table
Volume pricing table screenshot
In order to stimulate sales, you can add our "Volume Pricing Table" app block to your product page.
The contents in the table are automatically set based on discounts you created in our app's admin dashboard.
If a product is eligible for a volume discount, the table will be displayed.
This feature is currently only supported on product pages.
Volume pricing table tuFew readers"Discounted Price" block FAQ
We encourage you to use CTRL+F (or Command+F) to search this page.
Troubleshooting the "Discounted Price" block
If you're having issues with the "Discounted Price" block, read this article, which explains how to resolve common issues.
How can I display multiple discounts on product pages?
You will need to add the "Discounted price" block to your theme multiple times. Read this article (/en/article/using-multiple-discFew readersHow can I customize the CSS?
To customize the appearance of discounts on product pages, you need to edit the CSS of the app blocks you are using.
For example, if you want to change the color of discounts on product pages, you would need to provide color: red as a setting to one of the blocks.
Which instructions to use depends on which app blocks you are trying to customize:
Discounts Embed (new DOPP)
You can find CSS options in the "Discount Embed" app embed settings. They are explained in this article (https://regFew readersUsing Variant Selectors with Discounts on Product Pages
Depending on your theme, you might not be able to have the on-page prices automatically updated when the customer selects a different variant.
Not every theme is fully integrated out of the box
Please read our "Supported Themes" article to learn which themes have special support for variant selectors.
The Discounted Price Block is based on Dawn
Relevant excerpt from our "Limitations of the Discounted Price Block" artiFew readersDiscount Badges FAQ
Screenshot of a badge, surrounded in red
When displaying discounts on product pages, our app can also edit the contents of sale/discount badges.
Badges signal to users that an item is on sale. For example, in most themes, if a product has a compare-at price, a badge is shown.
How to Edit Badge Content
The "Discounts Embed" app block has aFew readersDOPP API: Examples
This guide provides practical examples for using the DOPP API to manage and customize discount flows on your store. Each example covers a real-world scenario, helping you understand how to implement features like overriding cart items, specifying product collections, and reloading discounts in dynamic situations such as variant changes or infinite scrolling.
Example Scenarios
Override Cart Items for Bundle Discounts
Specify Product Collections for Collection-Based DiscountsFew readersSetting Up Multiple Recommendations Discount Blocks Per Page
Please follow the same instructions as Setting Up Multiple Collection Page Discount Blocks Per Page , just with the following adjustments:
Use the data-regios-dopp-product-recommendations-block-key, instead data-regios-dopp-collection-block-key.
If you're using Custom Theme Setup , add this attribute to theFew readers
How to Use Regios Automatic Discounts
Welcome to Regios Automatic Discounts!
Click the thumbnail below to watch a welcome video from our founder:
Click to watch a welcome video from our founder.
Read the articles linked below to learn how to use our app:
Capabilities of Regios Automatic Discounts (/en/article/capabilities-of-regios-automPopularHow to Test Your Automatic Discount On Your Store
Once you've created a discount, we recommend testing it on your store to make sure everything is working properly.
Step 1. Use the "Test discounts" page
"Test discounts" page tutorial video thumbnail
We have created a "Test discounts" page in our app, that lets you:
Preview how discounts will apply with different items in the cart, different cPopularAbout the Advanced Logic Builder
Our advanced logic builder allows you to set complex logic and conditions for your discounts. Like Shopify Flow, it is a flowchart builder that lets you chain together conditions and actions.
Click to watch a brief tutorial video about the advanced settings page.
Click the thumbnail above to watch our foPopularAbout the Discount Settings Page
This page allows you to set up automatic product, order, and shipping discounts.
Click to watch a brief tutorial video about the discount settings page.
Need help?
If you have questions or concerns, please consult our FAQ, or press the chat button at tSome readersDiscount Value Options in Regios Automatic Discounts
Regios Automatic Discounts offers multiple options you can use to decide which discount amount to apply to eligible products:
Percentage (ex. "5% off shirts")
Fixed amount (ex. "$5 off shirts")
Fixed price (ex. "Shirts cost $15")
Buy X, Get Y (ex. "Buy 2 shirts, get 1 shoe free")
Volume/tiered/quantity breaks (ex. "5% off for 5-9 items, 10% off for 10+ items")
Percentage
ScSome readersHandling Sale Price/Compare At Price in Regios Automatic Discounts
Screenshot of the "How to handle items already on sale" options card
Sometimes, products in your store are on a storewide sale. In Shopify, the "price"/"compare at price" are completely separate from the discounting system, which often causes confusion.
Every merchant has a different idea for how these products should be handled by discount apps. In order to give you control over the behavior, we have addedSome readersApplying Discounts Based on Customer Metafields
Regios Automatic Discounts lets you create discounts that only apply to customers with specific metafield values. This can be useful for creating loyalty programs, or integrating with other Shopify apps.
You can only read the value of 1 metafield in your discount, even if you are using the advanced logic builder. Shopify Functions only allows us to request a limited amount of data about the cart when calculating discounts, so we could only fit 1 metafield into the limit.
To create a metafiFew readersCustomer Eligibility Options in Regios Automatic Discounts
Screenshot of customer eligibility options
Regios Automatic Discounts offers multiple options you can use to filter which customers can receive a specific discount.
All customers: All customers, including customers who are not logged in, will receive this discount.
Specific customer tags: Only customers with these specific tags will be eligible. Be sure to press ENTER to add a tag.
SpecFew readersDiscounted Price Block
IMPORTANT: This feature has several limitations.
To get updates about the new version, which will address these limitations, upvote and comment on this thread in our public feedback board.
Watch this video tutorial to see our founder walk you through setting up our "Discounted price" app block:
Video tutorial thumbnFew readersLogic Builder: Discount Conditions
Our advanced logic builder offers a number of conditions you can chain together to get very precise about who will receive which discounts.
Here's a breakdown of them all:
Video of our founder walking through the available conditions
Click the thumbnail above to watch a video of our founder walking through the different conditions available.Few readersProduct Eligibility Options in Regios Automatic Discounts
Screenshot of product eligibility options
Regios Automatic Discounts offers multiple options you can use to filter which products can receive a specific discount:
All products: All products will be eligible.
Specific collections: Only products in selected collections will be eligible. Due to restrictions in Shopify itself, you can only select up to 100 collections in a single discount (includFew readersHow to Use The Test Discount Page
Tutorial video thumbnail
Click the thumbnail above to watch our founder demonstrate how to use this page.
The "Test discounts" page allows you to:
Preview how discounts will apply with different items in the cart, different customers, etc.
Troubleshoot why your discount isn't applying as expected, wiFew readersHow to Create Volume Discounts
Tutorial video thumbnail
Click the thumbnail above for a video demonstration.
Create Product Discount
Click on "Create Product Discount" in the app.
Choose between a discount code or automatic option.
Enter a title for the discount (e.g., volume example).
Edit Logic
Screenshot of the "Bulk/volume discount for spFew readersApplying Discounts Based on Customer Location
Regios Automatic Discounts lets you create discounts that only apply to customers in specific countries. This can be useful for international stores.
This requires Shopify's Geolocation app. Location detection is based on the customer's geolocation, OR the shipping address location (whichever is available).
To create a location-specific automatic discount, select "Customers in a specific location" in the "Discount applies to customers" section of the discount setup form.
Screenshot of tFew readersPurchase Requirements Options in Regios Automatic Discounts
Screenshot of a "minimum/maximum purchase requirements" condition
You can use minimum/maximum purchase requirements to:
Increase average order value (AOV) by incentivizing larger purchases
Prevent major losses by limiting how big of an order can be discounted for specific customers
Options available for defining the minimum/maximum quantity:
No minimum/maximum requirements: All line items will paFew readersAuto Add to Cart/Free Gift With Purchase
Screenshot of an "auto add to cart" logic flow
Our app now supports creating "auto add to cart" offers, where 1 or more product variants are automatically added at checkout when specific conditions are met.
Use Cases
Offering a free gift with purchase (ex. Spend $300 or more, get this item for free)
Automatically adding "shipping protection," "purchase protection," or similar warranties to the cartFew readersApplies To Options
Screenshot of "Applies to" option
Specific discount types, such as volume and fixed price discounts, have options that let you choose which group of cart line items they apply to.
For example, you might want to only apply a fixed price discount to products in a specific collection.
The "Applies to" option allows you control over this.
In the advanced logic builder, you can also use the "Applies to" optioFew readersSelling Plans Options in Regios Automatic Discounts
You can make a discount apply to only one-time purchases or subscriptions using this condition.
Basic logic builder
Screenshot of the "Subscriptions and selling plans" options
Options available for including selling plans:
Discount applies to subscriptions and one-time purchases: All line items will pass this condition.
Discount only applies to one-time purchases: Only one-time purchase linFew readersUsing Regios Automatic Discounts with Draft Orders
Does your app depend on draft orders?
Our app does not depend on draft orders. Our discounts are implemented using a Shopify API called Shopify Functions, which can apply to normal orders on multiple sales channels.
How to apply automatic discounts when sending invoices
As of October 2024, it is now to apply Shopify Functions discount in the draft order checkout.
A screenshot of the "Allow customers to apply discount codes when paying this invoice" checkbox (https://storage.crisp.Few readersShipping Method Eligibility Options in Regios Automatic Discounts
Screenshot of an include/exclude shipping methods condition
In our app, you can limit shipping discounts to specific shipping methods.
IMPORTANT: This is based on the title of the shipping method in checkout, NOT the name of the app that provides shipping rates.
For example, if you have "Shipstation" checked:
The discount will only be applied if the shipping method name in checkout is "Shipstation"Few readersMigrating to the New DOPP
If you were using the "Discounted Price" block before March 24th, 2024, then follow these instructions to upgrade to the new version of the "discount on product page" (DOPP) feature, which fixes the limitations of the "Discounted Price" block.
Tutorial video thumbnail
Click the tFew readersShipping Discounts
Screenshot of a shipping discount applying to shipping methods in checkout
Screenshot of a shipping discount applying to the order total in checkout
In addition to product and order discounts, our app supports creating shipping discounts.
Differences between shipping discounts and other discounts in Shopify
In ShopifFew readersQuantity Input
Screenshot of the "Quantity" input on a percentage discount
In many cases, you'll need control over the exact number of items a discount should apply to. You can do this by setting the "Quantity" of a discount to one of the following:
Zero
A positive number
A negative number
You can find the "Quantity" input in the "Advanced options" when creating an "Apply discount" step in our advanced logic buildFew readers