Show the discounted price on your product pages

• At least one product discount created in Pixoo. Automatic or code, a fixed amount or a percentage, on specific products or on collections. Order discounts and shipping discounts do not show on product pages.
• An Online Store 2.0 theme. Horizon, Dawn, and most themes from the Shopify Theme Store. Pixoo finds the price element by itself on these; on a custom theme, an app block does the job. Both are covered below.
• Five minutes. The setup is two switches and one theme editor visit, most of it done once for both storefront features.

1. 1

   Activate the Pixoo storefront app embed

   In your Shopify admin, open Pixoo, then Storefront, then the Prices & codes tab. Next to App embed, click Open theme editor. Your theme editor opens on the app embeds panel: toggle Pixoo storefront on, then click Save in the editor.

   Back in Pixoo, the status next to App embed reads "Active" once the script has run on your storefront. Open any product page of your store to trigger it, then click Check the status.

   This embed is shared with the cart progress bar. If you already activated it for the bar, this step is done.

2. 2

   Turn on discounted prices

   In the section Show discounted prices on product and collection pages, switch on Show discounted prices. Choose where the line appears: Product pages, Collection cards, or both. Click Save in the bar at the top.

   

3. 3

   Check which discounts are shown

   The section Which discounts are shown lists every product discount of your store. Each automatic discount reads Shown, Off, or Excluded with the reason in plain words. Use the switch on the right to hide a discount you would rather keep as a cart surprise. The change applies without saving the page.

   The same switch lives on the discount itself: open a product discount in Pixoo and look for the Storefront card, right after the customer message.

   

4. 4

   See it on your store

   Open a product covered by one of the shown discounts. The line appears under the theme price. Add the product to the cart: the cart total confirms the same price.

   A change made in Pixoo can take up to ten minutes to reach the storefront, because the storefront keeps a copy of your settings for five minutes and your browser may keep one too. Open the page in a private window if you want to see it right away.

   To understand what the page decided, add ?pixoo_debug=1 to the product URL. A panel in the bottom left corner lists the discounts received, whether each one applies to this product and why, and where the line was placed. Only you see it, and only with that parameter.

   

1. 1

   Switch on the surface

   In Show discount codes on product pages, switch on Show discount codes and save. Nothing is visible yet: this only opens the door.

2. 2

   Switch on each code

   In Which discounts are shown, the code discounts are listed below the automatic ones, all Off. Switch on the ones you want to publish. Codes you leave off, and every code you create later, stay private.

3. 3

   What the shopper sees

   A badge with the code and what it is worth on this item, for example "Use code SUMMER10, 10% off this item". A click copies the code and shows a short confirmation; the shopper enters it at checkout as usual. On a store with market codes, the badge shows the code of the shopper's market.

   

• Same arithmetic as the checkout. The amount shown is the one you set for the shopper's currency. For a currency you did not set, with conversion enabled on the discount, Pixoo converts with the store's own rate and rounds the way the checkout does.
• Doubt means silence. A discount whose outcome depends on something the page cannot see (the cart total, who the shopper is, a variant condition) is never shown. It is listed as excluded in the admin with the reason.
• Checked at the first add to cart. When the shopper adds a product whose price was displayed, Pixoo reads the cart and compares the discount Shopify actually applied with the one displayed. They match to the cent, or the display hides itself for the rest of the session and Pixoo records the mismatch so we can look into it.
• Best single discount, like Shopify. When several discounts cover a product, the page shows the largest saving for one unit, which is what the checkout picks. If two tie, the amount is shown and the discount name is left out, since the page cannot tell which one the checkout will name.

Traps we hit while testing

We set up the feature on two themes and a dozen discounts before releasing it. These are the moments where we thought something was broken and it was not.

I switched currency and the price did not change

The discount had an amount for one currency only. A fixed-amount discount applies in the currencies you gave an amount for, plus the others only if you enabled conversion on the discount. In a currency where the discount does not apply, the page shows the theme price and nothing else, which is correct. Check the discount's currencies, or test in one you configured.

I created a discount and it is not in the list

Pixoo re-reads your discounts at most once every ten minutes, so a discount created a moment ago can be missing from the list until the next refresh. Reload the tab after ten minutes; it will be there, Shown or Excluded with its reason. Discounts edited in the Shopify admin (renamed, paused) are refreshed the same way.

I changed a setting and the store still shows the old one

The storefront keeps a copy of your settings for five minutes, and your browser may keep the page for a few more. Ten minutes is the worst case. A private window shows the new state sooner. While waiting, the diagnostic panel shows what the page currently has.

The code badge shows on some products and not others, with the same discount

On the products where an automatic discount already applies, there is no badge on purpose: Shopify keeps one product discount per item and would refuse the code there. We hit this with a code and an automatic discount on the same collection; the checkout refused the code, so the badge would have lied.

The line shows the amount but not the discount name

Two discounts give the same saving on that product. The amount is certain, the name the checkout will pick is not, so the page shows the amount only.

The discounted price is written differently from my theme prices

It should not be: the line uses your store's money format (decimal separator, currency symbol, position). If you spot a difference, send us the product URL.

On Horizon, the block was added at the bottom and I cannot move it

The theme editor adds an app block at the end of the template and does not let you drag it into a group such as Details. Delete it, open the Details group, click Add block, Apps, Pixoo product price, and it sits under the price. Once it is inside the group, you can drag it within it.

I activated the embed but I am previewing another theme

App embeds are per theme. The Open theme editor link activates the live theme; a draft theme you preview needs the embed toggled in its own editor. The status in Pixoo reads Active as soon as any theme with the embed has loaded a page.

A discount on a "small sizes" collection is excluded

Shopify collections can now contain single variants. A collection that selects variants by a condition (variant title contains "S", for example) cannot be replayed on a product page exactly, so the discount is excluded. A collection where you picked the variants by hand works: the page knows exactly which ones.

A "10% off from 3 items" discount shows no discounted price

One unit does not qualify, so the page shows the hint "10% off from 3 items" under the price and leaves the price alone. The discounted price appears in the cart once the quantity is reached.

A capped discount (for example 5 items max) shows on the product, and the cart total is different

The cart applies the cap; the product page prices one unit, which is within the cap, and adds the "max. 5 items" mention. A shopper buying more than the cap sees the difference in the cart, with the mention having said so.

When something does not show

Nothing shows on any product page

Check, in this order: the app embed status reads "Active" in Pixoo; the Show discounted prices switch is on and saved; the discount reads Shown in the list, not Off or Excluded; the product is actually covered by the discount, in the market and currency you are browsing in. Then wait ten minutes or open a private window. The diagnostic panel tells you which of these is missing.

It shows on some products but not others

The discount targets specific products, variants, or collections, and the page follows that exactly. A product with a compare-at price is skipped when the discount is set to full-price items only. A variant-condition collection is not supported (see above).

The line disappeared after I edited the discount

The storefront still had the previous version of the discount for a few minutes and the cart check found a difference, so the display hid itself for that browser session. Open a new tab, or wait ten minutes. Nothing was shown to shoppers that the checkout would not have given.

The line lands in the wrong place, or the panel says no price element was found

Add the Pixoo product price block under your price in the theme editor, as described in Placement above. If the block is not an option on your theme, use the selectors in Advanced, or send us the store URL.

A discount reads Excluded and I do not understand why

The reason is written under its name in the list. Most often the discount has a minimum purchase amount (the progress bar is the right surface for it), is spread once per order, or is limited to customer tags or segments. Editing the discount makes it qualify the next time the list is refreshed.

Collection cards show the line for some products only

On a collection page, Pixoo prices the first fifty products of the collection. Beyond that, and on the next pages of a paginated collection, the theme price is left untouched rather than replaced by a guess. The product page always shows the line.

A shopper copied a code and it was refused at checkout

Check whether an automatic discount also covers that product: Shopify keeps the automatic one and refuses the code. Pixoo hides the badge in that case, but a discount created or changed in the last ten minutes may not have reached the page yet. Also check the code's own limits: schedule, markets, usage limit, once per customer.

Still stuck? Email support@pixoo.app with your store domain and, if you have one, a screenshot of the diagnostic panel. We will look at it directly.

Related reading: setting up the cart progress bar and the complete guide to multi-currency discounts.