Reference
Documentation
Last updated : 18 August 2026
Reference for every setting and every rule. If you are setting up for the first time, the getting started guide is the faster road.
1. Offer types and how they are calculated
Every item vs. the next item
Each tier applies its discount one of two ways:
| Mode | Rule | Example on 3 items at €20 |
|---|---|---|
| To every item | Every unit in the tier is reduced. | Buy 3, -15% → €51 instead of €60 |
| To the next item | One unit per completed group of n is reduced. | Buy 2, -50% on the next → one unit at €10, so €50 |
In “next item” mode the reduction is spent on the cheapest unit in the group. That is what shoppers expect from a mixed lot, and it never over-discounts.
Which tier applies
The highest tier the quantity reaches — not the most generous one. With “buy 3 save 20%” and “buy 5 save 10%”, a shopper buying five gets 10%, which is worse than buying three. Always make each tier more generous than the one below it. The editor flags it when you do not.
Quantities are counted per product
Two small and two medium of the same t-shirt are four items towards a tier of three, even though Shopify keeps them on separate cart lines. This is what lets a shopper mix variants inside one tier.
Different products never combine. Three of product A and one of product B are a tier of three and a lone item, not a tier of four.
Percentage or fixed amount
A fixed amount is per item, not per order: “€5 off” on a tier of three takes €15 off. A discount larger than the item's price reduces it to zero, never below.
2. Products and collections
A product belongs to one bundle at a time. Two bundles would write the same offers onto the same product and the last save would silently win, so the app refuses it and tells you which bundle already has it.
Products picked by hand and products coming from a collection behave differently when the collection changes:
- A product you picked yourself stays in the bundle whatever the collection does.
- A product that arrived through a collection leaves the bundle when it leaves the collection.
Both manual and automated collections are followed. A product that starts matching an automated collection's rules inherits the offer without you touching anything.
3. Widget settings
Theme editor → your product template → the Redjam Bundles — Offers block.
Wording
| Setting | What it controls |
|---|---|
| Heading / Subheading | The two lines above the tiers. Leave the heading empty to hide both. |
| Default wording for an offer | Used when a tier has no text of its own. {q} is replaced by the quantity. |
| Unit price suffix | The words after the per-unit price, for example “each”. |
| Highlight badge | The label on the highlighted tier. |
| Button text | The widget's add-to-cart button. |
Display
| Setting | Default | What it does |
|---|---|---|
| Layout | List | Tiers stacked, or side by side in a grid. |
| Offer a single unit | On | Adds a one-item row at the normal price, so the widget covers every way of buying. |
| Show the crossed-out price | On | The undiscounted total, struck through. |
| Show the unit price | On | Price per item under each tier's label. |
| Let shoppers choose variants | On | One selector per item in the tier. No effect on a single-variant product. |
| Show the add-to-cart button | On | Turn off to use your theme's own button instead. |
| Hide the theme's buy buttons | On | Applies only where the widget shows. See below. |
About hiding the theme's buttons
With the widget on the page there would otherwise be three ways to buy: the widget's button, your theme's add-to-cart, and its accelerated checkout. The widget hides the other two, but only on products where it actually renders — a product without an offer keeps yours untouched, and stays purchasable.
When the widget also owns variant selection, your theme's variant picker is hidden along with them: the cart is built from the widget's selectors, so two pickers could disagree about what is being bought.
Nothing is modified in your theme files. The hiding is applied in the browser and disappears with the block.
Colours
Main colour, block background, offer background, text, borders, and corner radius. The defaults match Shopify's own green; most merchants set the main colour to their brand and leave the rest.
4. Cart progress settings
An optional block for your cart template. It tells a shopper what is missing to reach the next tier.
- Message before the tier —
[n]items still needed,[discount]the discount,[product]the product name - Confirm tiers already reached — show a message when a tier is met
- Message after the tier — that confirmation's wording
5. How discounts combine
The app's discount combines with order and shipping discounts, but not with another product discount. Where two product discounts target the same item, Shopify applies one and does not report which.
The dashboard lists any other active automatic discount so you can decide knowingly. It also warns you if two of the app's own discounts are running, which can happen on a store that installed under an earlier version.
6. Plans and limits
| Plan | Price | Bundles |
|---|---|---|
| Free | €0, no time limit | 1 active bundle |
| Monthly | €9.99 / month, 7-day trial | Unlimited |
| Annual | €99 / year, 7-day trial | Unlimited |
The limit is on creating bundles, not on running them. If a subscription lapses, existing bundles keep working; you simply cannot add another until you subscribe again.
7. Technical notes
How the discount is applied
Offers are mirrored into a product metafield that both the storefront widget and a Shopify Function read. The function runs at checkout and calculates the reduction from that metafield — which is why the shopper pays what the widget promised, and why no discount code is involved.
Performance
The widget reads its offers from the page itself, rendered by Shopify from the metafield. It sends no request to our servers, so your product pages are unaffected by our uptime and your speed score is unaffected by the app.
Permissions requested
| Scope | Why |
|---|---|
read_products, write_products | Read the products you select; write the metafield holding your offers. |
read_discounts, write_discounts | Create and find the automatic discount that runs the function. |
read_themes | Detect whether the widget block is installed, for the setup checklist. Read only. |
No order, customer or payment permission is requested. Details in the privacy policy.
Uninstalling
Remove the app from your Shopify admin. The theme block goes with it, no code remains in your theme, and your data is erased from our database 48 hours later.