Installation guides

Install on Squarespace

Squarespace's Code Injection adds the tag to the head of every page. It's available on the Core, Plus and Advanced plans and some legacy plans.

Open Code Injection
In your site's editor, search for Code Injection in the settings (it sits with the custom code and developer tools).
Paste the snippet into Header and save
Replace YOUR_SITE_ID with the public site ID from your site's Settings → Install card. The site ID is public and safe in browser code; never put your secret key in a page.
Header
1
2
3
4
5
```
<script
  defer
  src="https://metricraven.com/js/script.js"
  data-site-id="YOUR_SITE_ID"
></script>
```
Use the site-wide Header field, not a single page's header code injection.
Open your live site
Check a page on your public domain in a private window, logged out of Squarespace.

Verify it works

Open your live website in a normal browser window (not an automated or embedded one). In the browser's Network panel, look for script.js and then a request to /api/v1/collect whose response contains ok: true. Open your site's Traffic tab and choose Refresh; the selected dates must include your visit.

Nothing showing? See Troubleshooting.

Notes

Squarespace runs injected code in the editor preview too, so your own editing can be counted. Exclude your browser; see Exclude your visits.
Squarespace checkout pages don't run custom code, so checkout steps aren't recorded.
Use the site-wide head code setting, not an embed or HTML widget: widgets that place code inside an iframe are ignored by the tracker.
Only hostnames listed in your site's Settings → General → Site domains (and their subdomains) are accepted. To also count visits on a platform address such as your-site.squarespace.com, add it there; otherwise those requests are refused with domain_not_allowed.
If you use a cookie banner, connect it with Consent & visitor IDs.

Optional script attributes are listed in Install & verify. To exclude your own visits, see Exclude your visits.