Shop Settings holds the options that apply to every offer in Bundles & Discounts. Use it to make Shopify check offer quantities in the cart, hide Appstle's internal line item properties on your cart page, keep offers off certain pages, switch offers off for a while, and choose how prices are formatted.
To open it, go to Settings → Shop Settings in the app. After you change a setting, click Save in the bar at the top of the page.
The settings that change your storefront work only while the Appstle Bundles app embed is on. To check, go to Online Store → Themes → Customize and open App embeds.
What each setting does
This list covers every setting on the page, in the order they appear.
Proxy Path: tells the app which app proxy path your store uses. It must match the app proxy URL in Shopify.
Validate Discount Quantity: blocks carts whose quantity falls outside an offer's limits.
Disable App Functionality: pauses every Appstle offer on your storefront, and their discounts at checkout.
Cart Hidden Attributes Selector: hides Appstle's line item properties on your cart page.
Shop Currency Format: shows prices in volume discount and Combo bundle widgets with or without the currency code.
Volume Discount Storage Model: moves volume discounts to the newer storage model. Only older shops see it.
Bundle Excluded Paths: keeps offers off the pages you list.
Validate Discount Quantity
Turn this on when shoppers must stay inside the quantity limits of your offers. With it on, Shopify checks the cart against your Dynamic pricing bundles, volume discounts and Product discounts. If the quantity is outside an offer's limits, the items aren't added and the shopper sees an error message.
Turn it on
Go to Settings → Shop Settings.
Under Quantity Validation Settings, tick Validate Discount Quantity.
Click Save.
When you save, the app adds its quantity check to Shopify as a checkout rule named cart-checkout-validation. It must stay Active under Settings → Checkout → Checkout rules in Shopify admin. If you turn it off there, saving here doesn't turn it back on.
Important: The check blocks a quantity outside an offer's limits even when the shopper pays full price. With tiers at 3 and 6, shoppers can no longer buy 1, 2 or 7 of that product.
What shoppers see
When the cart's quantity doesn't fit, the shopper sees Orders must match the quantity range: Min 2, Max 5, with the numbers for that offer, and Shopify doesn't add the items. Where it shows depends on your theme. In the example below, it shows next to Add to cart.
In Appstle's Slider Cart, the message shows above the checkout button, and shoppers can't check out until the cart fits.
To change the wording, go to Design, open Texts shoppers read, and edit Wrong quantity under Cart and checkout. Keep {{min_quantity}} and {{max_quantity}} in the text so the numbers appear.
The message is shown as you write it, in every language your store uses.
A Dynamic pricing bundle's box follows the same limits on its page. Shoppers can't check out a box with fewer items than the lowest limit, or add items past the highest.
How the limits work
The limits come from the offer. For a volume discount, they're its smallest and largest tier quantities. For a Product discount, they're its Minimum items and Maximum items, checked for each variant on its own, even when Count items is Everything in this offer together. For a Dynamic pricing bundle, they're the box's At least and Up to counts, or its smallest and largest tier when those are empty.
A volume discount counts the cart the same way it gives the discount. With Yes, any product in this offer under Can shoppers mix items?, all the offer's items count together. With Yes, variants of one product, each product's variants count together. For example, 2 blue and 2 red candles in a Mix and match offer count as 4.
A volume discount set to One-time purchases only or Subscriptions only under Purchase options limits only those purchases. A Product discount limits both kinds of purchase, whatever its Purchase options say.
Any quantity between the lowest and highest limit passes, even when it isn't a tier. With tiers at 3 and 6, a cart of 4 passes.
Today, the check doesn't follow an offer's schedule. An offer that shows Scheduled or Ended in your offers list limits quantities like a live one. When an offer ends, turn it off so shoppers can buy any quantity again.
Today, the check also ignores the customer tags and markets under Who gets it. An offer for tagged customers only limits quantities for every shopper, including guests and customers without the tag, even though they don't get its discount.
In a Dynamic pricing bundle with products set to Must be in the box, the check also blocks a cart that's missing one. Shoppers then see the Required product missing text from the same Cart and checkout group.
The note under the checkbox says shoppers must select exactly the specified quantity, but the check is a range. To allow only the exact tier quantities, keep Validate Discount Quantity on and also tick Enforce exact tier quantity at checkout on the Discount Configuration tab under Settings → Bundle Configurations. You can then add
{{allowed_quantities}}to the Wrong quantity text to list the allowed quantities.Enforce exact tier quantity at checkout keeps the check running even when Validate Discount Quantity is off. To stop the check, untick both.
The setting is for your whole store. You can't turn it on for one offer only.
Turning on Disable App Functionality switches the check off as well.
Offers the check skips
Today, Shopify doesn't check these offers, so their quantities aren't limited:
Volume discounts set to Specific products and No, the same variant only (under Can shoppers mix items?), unless they use the Legacy widget.
Volume discounts on the Legacy widget set to Yes, variants of one product or Yes, any product in this offer.
Volume discounts set to Collections (under Which products get the discount?).
Product discounts set to Collections (under Discount applies to) or All variants of a product together (under Count items).
Cart Hidden Attributes Selector
When a shopper adds an offer's items, Appstle attaches line item properties to them, such as _appstle-bb-id and __appstle-bb-name. Some themes show these properties on the cart page. This setting hides them.
Hide the properties
Find the CSS selector of the element in your cart that shows one property. In your browser, right-click the property's text, choose Inspect, and note the element's class. Write a class with a dot in front, for example
.product-option.Go to Settings → Shop Settings.
Under Hidden Attribute Visibility Settings, enter the selector in Cart Hidden Attributes Selector. To use several selectors, separate them with commas. The field shows
.cart__item--hidden, [data-hidden='true']as an example of the format.Click Save.
Things to know
Only elements that match your selector and whose text contains
_appstleare hidden. Your own properties stay visible.Pick the element that holds one property, not the whole cart item. If your selector matches the whole item, the item disappears from the cart, because its text contains
_appstletoo.The selector is applied once, when the page loads. Cart items that your theme draws later, such as a cart drawer that refreshes after each change, aren't checked again.
The properties are hidden from view only. They stay on the item.
On pages listed under Bundle Excluded Paths, the properties aren't hidden, because the app doesn't load there.
Disable App Functionality
Use this to pause every Appstle offer for a while, for example during maintenance. Offers stop showing on your storefront, and their discounts stop at checkout. Your offers and settings aren't deleted. To keep offers off some pages only, use Bundle Excluded Paths instead.
Go to Settings → Shop Settings.
Under Disable App Functionality, tick Disable App Functionality.
Click Save. To turn offers back on, untick it and save again.
While it's on:
No offer widgets show on your storefront, including volume discounts, bundles, Buy X Get Y and the announcement bar.
Bundle pages show Oops! This bundle is temporarily unavailable. with an Explore Offers button that takes shoppers to your catalog.
No Appstle discount applies in the cart or at checkout, including volume, Product, bundle, Buy X Get Y and shipping discounts.
The quantity check stops.
Shop Currency Format
Choose how prices look in volume discount and Combo bundle widgets. Amount Only uses your Shopify store's money format, for example $18.00. Amount with Currency uses your store's money-with-currency format, for example $18.00 USD. Both formats come from your Shopify store's currency settings.
To change it, go to Settings → Shop Settings, choose an option in Shop Currency Format under Currency Format Settings, and click Save.
Bundle Excluded Paths
Offers load on every page of your store by default. Use this setting to keep them off pages where you don't want them, such as a blog or a contact page. On a listed page, the app's scripts and styles don't load, so no offer widget shows there. Discounts still apply at checkout when the cart qualifies.
Add a path
Go to Settings → Shop Settings.
Under Bundle Excluded Paths, type the path and press Enter. Each path becomes a tag.
Click Save.
Enter each path in one of these forms:
/turns offers off on the homepage only.//turns offers off on every page of your store.Any other path, such as
/pages/faq, turns offers off on every page whose address contains it.view:followed by a template suffix, such asview:volume, turns offers off on pages that use that alternate template, whether it's assigned to the product or opened with?view=volume.
Because a path matches any address that contains it, a short path can catch more pages than you expect. For example, /blog also matches /blogs/news.
Proxy Path
Your storefront reaches the app through a Shopify app proxy. Proxy Path, under General Settings, tells the app which path that is. It's apps/bundles unless you changed it. If you change the app proxy URL in Shopify admin under Settings → Apps → Appstle℠ Bundles (click Customize URL), enter the same path here and save. If the two don't match, pages that use the app, such as bundle pages, don't load properly.
Volume Discount Storage Model
Only shops that haven't moved to the newer storage model see this section. In the older model (V1), a volume discount keeps its whole product list on the discount. With many variants, that list can pass a Shopify size limit (128 KB), and the discount then stops applying without a message. The newer model (V2) stores the offer on each product instead, so the limit doesn't apply.
To move to V2, click Switch to V2 storage model, then Switch in the confirmation. You can't undo the switch from the app.
The app deletes the automatic discounts of your volume discounts set to Specific products and creates them again with new discount IDs. Volume discounts set to Collections don't change. The app then updates your products in the background, which can take a few minutes on stores with many products. While it runs, this section shows the progress.
Sync Shop Details
Click Sync Shop Details at the top right to refresh the store details the app keeps for your shop from Shopify: currency, time zone, plan name, country and store contact details. Use it after you change one of these in Shopify.
Troubleshooting
Why can shoppers still buy a quantity outside the tiers?
Check these in order:
Validate Discount Quantity is ticked and saved.
In Shopify admin, the cart-checkout-validation rule is Active under Settings → Checkout → Checkout rules.
The offer isn't one the check skips (see Offers the check skips above), and the items match its Purchase options.
The quantity is below the lowest tier or above the highest. Quantities in between pass unless you tick Enforce exact tier quantity at checkout.
Disable App Functionality is off.
Why can't shoppers buy one unit of a product?
With Validate Discount Quantity on, a quantity below an offer's smallest tier is blocked, even at full price. This includes offers that are Scheduled or have Ended, so turn off any offer you no longer run. It also includes offers for tagged customers only, whose limits apply to every shopper. If shoppers must be able to buy fewer of a live offer, turn the setting off.
Why do Appstle properties still show in my cart?
Check that the selector matches the element in your theme, that the element's text contains _appstle, and that the Appstle Bundles app embed is on. A cart drawer that redraws after each change shows the properties again, because the selector is applied only when the page loads.
Why did offers disappear from a page?
Check Bundle Excluded Paths for a path that matches the page, check that Disable App Functionality is off, and check that the Appstle Bundles app embed is on in your theme.




