Integration Guides
Ghost
Add Rybbit analytics to your Ghost publication
Ghost has a built-in Code injection setting that adds HTML to the <head> of every page, so no theme edits are needed.
Get your tracking snippet
In your Rybbit dashboard, open Site Settings → Tracking Script and copy your snippet. It looks like this:
<script src="https://app.rybbit.io/api/script.js?siteId=YOUR_SITE_ID" defer></script>YOUR_SITE_ID is the numeric ID of your site. If you self-host Rybbit, app.rybbit.io is the domain of your own instance.
Add the snippet to Ghost
- Open Ghost Admin and click the Settings gear in the bottom left.
- Under Advanced, open Code injection.
- Paste the snippet into Site header and click Save.
If you maintain your own theme instead, add the snippet to default.hbs just before </head>.
Verify installation
Open your live site in a new tab and click through a few pages. Within a few seconds the pageviews appear in the Rybbit dashboard.
If nothing shows up:
- View the page source and search for
script.js?siteId=to confirm the snippet is on the page. - Open the browser Network tab and check that
script.jsreturns200and thatPOSTrequests go to/api/track. - Disable ad blockers, or set up a proxy so the script loads from your own domain.
- See the script troubleshooting guide for other common causes.
Troubleshooting
- Ghost(Pro) with a custom theme: code injection still applies on top of the theme, so prefer it over editing
default.hbs. - Member-only content: pages behind the paywall are tracked like any other page for visitors who can view them.
- Portal and newsletter previews render in an iframe and are not tracked.
Next steps
- Track custom events such as signups, purchases and button clicks.
- Identify users to connect sessions to accounts.
- Proxy the script through your own domain to bypass ad blockers.
- Script attributes let you skip or mask URLs and tag events.