Ghost · free forever · no signup

Add a free page speed badge to Ghost

This guide shows how to add a Ghost page speed badge in about a minute, with no integration: you paste one snippet into Settings → Code injection → Site Header, because one paste in the head gives every page its own score — the badge auto-detects which page it's on. No integration to configure. Ghost renders raw HTML and script tags from Code injection and from an HTML card, so there is nothing to install and no third party in the loop.

What this Ghost 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 Ghost

  1. 1In Ghost admin go to Settings, then scroll to Code injection (under Advanced on newer versions).
  2. 2Paste the snippet into the Site Header box — it is injected into the <head> of every page.
  3. 3Click Save. It is live immediately; Ghost has no build step and no cache to purge.
  4. 4For script tags, prefer the Site Footer box just below: same coverage, nothing blocking paint.
Self-hosted, or editing a theme directly? Self-hosted and editing the theme instead? Add the snippet to `default.hbs` above {{ghost_head}} and restart Ghost. Code injection survives theme switches, so it's the safer of the two.

Where it works best on a Ghost site

On Ghost, the right spot is Settings → Code injection → Site Header. 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.

Ghost plan and editor requirements

Code injection is available on every Ghost(Pro) plan and on self-hosted Ghost, both sitewide (Settings → Code injection) and per post. HTML cards are available in the editor on all plans too. The main limit is on Ghost(Pro)'s entry plan, which doesn't allow custom themes, so use code injection or HTML cards rather than editing theme files.

Three things that trip people up on Ghost

Site Header vs Site Footer actually matters here

Ghost's whole appeal is speed. Putting a script in Site Header makes the browser deal with it before painting your post; Site Footer runs it after. Our snippet is async either way, so use the Footer box unless the widget must exist before first paint (the heatmap and the speed badge are the only two that benefit).

The editor shows markup, not the widget

An HTML card displays the raw code while you're writing and only renders on the published page. That's by design, not a failed paste. Publish (or use the preview link) and check the live URL — and remember post-level code injection doesn't run in preview at all on some versions.

Theme edits get wiped, Code injection doesn't

If you paste the snippet into a `.hbs` file, the next theme update or theme switch silently removes it. Code injection is stored in your Ghost settings, not in the theme, so it survives both. On Ghost(Pro) you can't edit theme files directly anyway — Code injection and HTML cards are the whole surface.

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 Ghost(Pro) and self-hosted Ghost, in Code injection and in the editor's HTML card, on any theme including Casper and Source
  • Bots filtered server-side on every visitor-counting widget

Ghost questions

Do I need an integration to add a page speed badge to Ghost?

No integration to configure. Ghost renders raw HTML and script tags from Code injection and from an HTML card, so there is nothing to install and no third party in the loop. Installing an integration for this would mean another dependency and update cycle just to show one widget.

Where exactly does the snippet go on Ghost?

Settings → Code injection → Site Header, 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 Ghost 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. Ghost is already the fastest mainstream publishing platform and the point is to keep it that way: the snippet is one async tag, so it never blocks your post from rendering. Site Footer is the right injection slot for script tags — Site Header is for things that must run before paint.

Does it work with page builders like Ghost admin?

Ghost admin: Settings → Code injection → Site Footer. Ghost editor: insert an HTML card. Post settings: per-post Code injection fields. Self-hosted themes: edit default.hbs above {{ghost_head}}. 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.