Craft CMS

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 Craft CMS

1. Open the template that owns your <head>. In a fresh install that is templates/index.twig. In a project with a base template, it is the underscore-prefixed layout file.
2. Add the tag before </head>:

<!DOCTYPE html>
<html lang="{{ currentSite.language }}">
<head>
    <meta charset="utf-8">
    <title>{{ siteName }}</title>
    <script src="https://app.onyxmetric.com/api/script.js?siteId=YOUR_SITE_ID" async></script>
</head>
<body>
    {% block content %}{% endblock %}
</body>
</html>

3. Any section template that extends the layout now loads the script:

{% extends "_layout" %}

{% block content %}
    <h1>{{ entry.title }}</h1>
    {{ entry.body }}
{% endblock %}

To keep the ID out of your templates, read it from .env with {{ getenv('ONYXMETRIC_SITE_ID') }}, or keep it in a Global Set.

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.