Skip to content

Add the Price History blocks to your theme

Price History shows shoppers its information through three app blocks, which you place on your product page in Shopify’s theme editor. Use one, two or all three. Each block has its own settings for colours and sizes, so it matches your store.

Block What shoppers see Use it if…
Price note a “Lowest price in 30 days” badge after a price drop, and the prior cheapest price next to a crossed-out price you sell to shoppers in the EU or EEA, or want the badge
Price history: On page a chart of the price over time and a 30-day summary, on the product page, behind a button or always open you want the history on the page itself
Price history: Side panel the same chart and summary, in a panel that slides in from a button, pill or text link you want to keep the product page short

The two Price history blocks show the same panel. Most stores use one of them, plus the Price note.

For the full story, read how to show price history on Shopify.

The quickest way is from the app. It opens the theme editor with the block already added.

  • Price history: on the app’s home page, click Add on the page or Add as a side panel. You’ll find the same links on the Storefront page.
  • Price note: on the Storefront page, click Add it in the theme editor on the Price note card.

Then, in the theme editor:

  1. Move the block to where you want it, for example just under the price.
  2. Change its settings if you like (see below).
  3. Click Save.

To add a block by hand: in Shopify’s admin, go to Online Store › Themes and click Customize. Open a product page, click Add block in the product information section, and pick the block from the list of apps. The blocks only work on product pages.

The app’s Storefront page shows on each card whether its block is on your live theme. The price history card also says which blocks are there: On page, Side panel, or both. A missing block shows Not on your live theme yet. It checks your published theme, so a block you added to an unpublished theme doesn’t count.

Two things, each on its own rules. Either, both or neither can show on a product:

  • The badge, “Lowest price in 30 days”: after a price drop, when today’s price is the lowest you’ve charged in the last 30 days. Crossed-out prices don’t count.
  • The note, “Prior cheapest price” and the price, with an ⓘ: when the product has a crossed-out price that differs from the prior cheapest price. The ⓘ explains it: “The lowest price we charged in the 30 days before this price cut.” If Price History started tracking less than 30 days before the cut, it says so, with the date.

You choose which countries see each one on the Storefront page, and change their wording on the Labels page. Read how the prior price is worked out.

Price note settings:

  • Badge and note: Badge above the note, or Side by side when there’s room
  • Alignment
  • Badge: Background and Text colours
  • Prior cheapest price: Text colour. Leave it empty to use your theme’s text colour.

The panel is the same in both Price history blocks:

  • A chart of the price over time, with tabs for 1M, 3M and 1Y. The longer tabs appear once the history goes back that far. The chart labels the period’s highest and lowest prices. During a price cut, a third line can mark the prior cheapest price, in the countries where the Price note shows it.
  • A 30-day summary, in a sentence or two. For example: “Over the past 30 days, the price has ranged from €40.00 to €50.00.” When the price is cut, it also gives the prior cheapest price, in the countries where the Price note shows it. The summary always covers the last 30 days, whichever tab is open.
  • A list of changes (off by default), 10 to a page.

It follows the variant the shopper picks. Pointing at or tapping the chart shows each price, the date it began, and any label. Under the summary, a note says prices are the listed price, before discount codes and shipping.

You choose which countries see it and how far back on the Storefront page.

What are the Price history: On page settings?

Section titled “What are the Price history: On page settings?”
  • Show the chart and list: Behind a button (shoppers click “Price history” to open it) or Always open
  • Accent colour: the chart’s line, the shading under it, and the range tabs
  • Show chart, Show the 30-day summary and Show change list
  • Max prices in the list: leave it empty for all of them, up to 100
  • Link the chart and change list: pointing at a price in the list shows it on the chart, and the other way round. It needs both the chart and the list.
  • Font size (px): 14 by default. The chart’s labels and tabs scale with it.

What are the Price history: Side panel settings?

Section titled “What are the Price history: Side panel settings?”
  • Style: Text link, Pill or Button
  • Accent colour: the chart’s line, the shading under it, and the range tabs. It also colours the button, unless you set the button’s own background
  • Button or link: Text colour, Font size (px), Margin top (px) and Margin bottom (px). For a pill or button, also Background, Padding left and right (px) and Padding top and bottom (px). For a button, also Corner radius (px).
  • Panel: what it shows (chart, summary, list, as above), and its Background, Text and Font size (px)

The button or link says “Price history”. You can change that wording on the Labels page.

Will the blocks slow my product pages down?

Section titled “Will the blocks slow my product pages down?”

No. Each product’s price history is saved in your Shopify store itself, so the blocks show with the rest of the page, without waiting on our servers. They make no requests while the page loads. After that, they make only small ones: they fetch the block again when a shopper picks another variant (unless your theme already redraws it), and they count a view, only when Shopify’s consent tools allow analytics for that shopper.

No. The blocks never show the Price History name or a link to us, on any plan.

Why does the theme editor show a message instead of the block?

Section titled “Why does the theme editor show a message instead of the block?”

When a block would show nothing to shoppers on the product you’re previewing, the theme editor says why. Shoppers never see these messages. The reasons are:

  • On the Free plan, the product isn’t one of your chosen products.
  • The product’s price hasn’t changed yet, or not in the time shoppers can see.
  • The price history is hidden in the country you’re previewing from.
  • For the Price note: the badge and the note are both turned off on the Storefront page.

Read common questions for more.

I’m a theme developer. Where are the technical details?

Section titled “I’m a theme developer. Where are the technical details?”

Read the theme developer guide. It covers every setting and its default, how the blocks follow variant and currency changes, and which CSS classes and custom properties your theme can rely on.

Need a hand? Email support@pricehistory.io.