Installation guides

Install on Framer

Paste the script into the site-wide head code, then publish.

Copy your snippet
In MetricRaven, open your site's Settings → Install card and copy the script tag. It already contains your site ID.
Open your site settings and find Custom Code
Framer may limit custom code to paid site plans.
Paste it into the end of <head> field
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.
End of <head>
1
2
3
4
5
```
<script
  defer
  src="https://metricraven.com/js/script.js"
  data-site-id="YOUR_SITE_ID"
></script>
```
Publish your site
Custom code runs on the published site, not in the editor preview.

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

If your site switches pages without a full reload, the tracker still records each page through the browser history API.
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 → Site domains (and their subdomains) are accepted. To also count visits on a platform address such as your-site.framer.website, 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.