Shopify · free forever · no signup

Add a free page speed badge to Shopify

This guide shows how to add a Shopify page speed badge in about a minute, with no app: you paste one snippet into theme.liquid, just before </head>, because one paste in the head gives every page its own score — the badge auto-detects which page it's on. No app. Shopify renders raw HTML and script tags inside a Custom Liquid block, so there is nothing to install from the App Store.

What this Shopify page speed badge shows

The page speed badge shows the page's mobile load speed and Lighthouse performance score, measured with Google's PageSpeed Insights API. It's a public, verifiable claim that your site is fast, which matters most to developers, agencies and anyone selling web work. The score is cached rather than re-tested on every visit, so the badge itself stays light.

How to add a page speed badge to Shopify

  1. 1In Shopify admin go to Online Store → Themes, then click the ⋯ button on your live theme and choose Duplicate — that copy is your rollback.
  2. 2On the live theme click ⋯ → Edit code, and open layout/theme.liquid from the Layout folder.
  3. 3Find the closing </head> tag and paste the snippet on the line directly above it.
  4. 4Click Save. It is live immediately — Shopify has no cache to purge.
Older theme, or no Custom Liquid block? Don't want to touch code at all? Add the snippet as a Custom Liquid block inside a section that appears on every page (the footer, or the announcement bar). You lose nothing except the <head> position, which only matters for the heatmap and the speed badge.

Where it works best on a Shopify site

On Shopify, the right spot is theme.liquid, just before </head>. Paste it once in the head and every page gets its own score, because the badge detects the page it's on. Show it where it supports a claim you're making, such as a footer on an agency site or next to a 'fast hosting' promise, and only once the score is one you're happy to show.

Shopify plan and editor requirements

Every Shopify plan lets you edit your theme code and add a Custom Liquid section, so no upgrade is needed. The one platform-wide restriction is checkout: Shopify doesn't allow third-party scripts on checkout pages, so widgets work everywhere else in your store, including the home, collection, product, cart and blog pages.

Three things that trip people up on Shopify

Check which theme you actually edited

Shopify lets you customise an unpublished theme, and the editor looks identical either way. If you pasted the snippet, saved, and the live store shows nothing, you almost certainly edited a draft or the duplicate you made as a backup. Online Store → Themes shows which one is under Live — edit that one, or publish the one you edited.

Use Custom Liquid, never the visual editor

Shopify's rich text editor for pages, articles and product descriptions strips script tags on save without warning you. The Custom Liquid block, the <> Show HTML view, and raw .liquid files in Edit code all pass markup through untouched. If your snippet disappeared the moment you saved, that is the reason.

Checkout pages are off limits

Shopify does not allow third-party scripts on checkout — that is a platform restriction, not a widget limitation. Everything else is fair game: home, collection, product, cart, blog, pages and the 404. Put the widget in the footer and it covers all of them in one paste.

Honest limits

It's a lab test from Google's servers, not a measurement of your real visitors, and the number moves a little between tests. A slow score is shown as it is, so fix the page before you put the badge on it.

What you get, and what it costs

  • Free forever — there is no paid tier, no trial and no card
  • No signup for the badge-style widgets; the live ones create a site ID inline from your URL
  • Async script — it never blocks your page from rendering
  • Works on Dawn and every other Online Store 2.0 theme, on older vintage themes, and inside Shogun, PageFly and GemPages
  • Bots filtered server-side on every visitor-counting widget

Shopify questions

Do I need an app to add a page speed badge to Shopify?

No app. Shopify renders raw HTML and script tags inside a Custom Liquid block, so there is nothing to install from the App Store. Installing an app for this would mean another dependency and update cycle just to show one widget.

Where exactly does the snippet go on Shopify?

Theme.liquid, just before </head>, because one paste in the head gives every page its own score — the badge auto-detects which page it's on.

Will it slow my Shopify site down?

It adds one small script, loaded asynchronously, so it doesn't block your page from rendering. Any third-party script has some cost, so check your page speed before and after adding it. Shopify serves your storefront from its own CDN and that doesn't change — the snippet is a single async tag, so it loads alongside your theme instead of in front of it. Nothing needs excluding from Shopify's own minification.

Does it work with page builders like Shogun?

Shogun: drag in the HTML/Liquid element and paste there. PageFly: use the HTML/Liquid element. GemPages: use the Liquid element. Shopify's own theme editor: add a Custom Liquid block. Any builder with a raw-HTML or code block will render it.

Where does the speed score come from?

From Google's PageSpeed Insights API, using the mobile test. The result is cached, so the badge doesn't run a new test every time someone loads your page.