Installation guides

Install on Webflow

Use the site-wide head code field, 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 Site settings → Custom code
Find the Head code field. Webflow may require a paid site plan for custom code.
Paste the snippet into Head code 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.
Head code
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 Designer canvas.

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

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.webflow.io, 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.