Eleventy

Copy your tracking snippet

In OnyxMetric, open your site's Site Settings and copy the tracking script. It looks like this:

<script src="https://app.onyxmetric.com/api/script.js?siteId=YOUR_SITE_ID" async></script>

YOUR_SITE_ID is the numeric ID of your site.

Add the snippet to Eleventy

1. Create _data/onyxmetric.json (and the _data/ folder if needed). Templates can then read it as onyxmetric:

   { "siteId": "YOUR_SITE_ID" }

2. Add the tag to the base layout's <head>. The runMode check keeps the script out of --serve and --watch, and the siteId check keeps it out of builds with no ID:

<head>
  ...
  {% if eleventy.env.runMode == "build" and onyxmetric.siteId %}
    <script src="https://app.onyxmetric.com/api/script.js?siteId={{ onyxmetric.siteId }}" async></script>
  {% endif %}
</head>

<head>
  ...
  {% if eleventy.env.runMode == "build" and onyxmetric.siteId %}
    <script src="https://app.onyxmetric.com/api/script.js?siteId={{ onyxmetric.siteId }}" async></script>
  {% endif %}
</head>

3. Build and deploy _site/:

   npx @11ty/eleventy

Check that it works

Load your live site and click through a few pages. Pageviews show up in the OnyxMetric dashboard within seconds.

If nothing arrives:

• View the page source and search for script.js?siteId= to confirm the tag is present.
• In the browser's Network tab, check that script.js returns 200 and that requests go to /api/track.
• Turn off ad blockers, or proxy the script through your own domain.
• Read script troubleshooting for other causes.