How-tos

Install the snippet

Every install is the same one-line script tag; only where you paste it differs. Get your site key from the dashboard (Add site), then place this before the closing </head> tag:

<script src="https://illumino.app/p.js" data-site="YOUR_SITE_KEY" async></script>

Plain HTML

Paste the tag into the <head> section of every page, or of your shared header include.

WordPress

Appearance, then Theme file editor, then header.php: paste before </head>. Prefer not to edit theme files? Any "insert headers" plugin works; paste the tag into its head section.

Shopify

Online Store, then Themes, then Edit code, then theme.liquid: paste before </head>.

Wix

Settings, then Custom code, then Add custom code: paste the tag, apply to All pages, load once, place in Head.

Squarespace

Settings, then Advanced, then Code injection: paste the tag into the Header box.

Next.js / React

Add the script in your root layout or _document:

<Script src="https://illumino.app/p.js" data-site="YOUR_SITE_KEY" strategy="afterInteractive" />

Google Tag Manager

New tag, then Custom HTML: paste the full script tag, trigger on All Pages. Note that some GTM setups are themselves blocked by ad blockers; the direct head tag is more reliable.

Verify data is flowing

Open your site in a regular browser tab, click through two or three pages, then open your Illumino dashboard. Your visit appears in the current period within a minute. The "Active now" card on the dashboard shows visitors from the last 30 minutes, which makes a fresh install easy to confirm.

"I see no data" checklist

Is the snippet in the page source? View source and search for illumino.
Does data-site match the site key shown in your dashboard for that exact domain?
Are you testing with an ad blocker enabled? It may block the snippet so nothing is sent.
Are you looking at the right date range in the dashboard?

Track custom events

After the snippet loads, call:

window.illumino('event', 'signup_click');

Keep names short, lowercase, and stable (signup_click, checkout_start); they become rows in the Engagement report. Verify an event by firing it once and checking Engagement for the name.

Exclude your own visits

Keep the dashboard's self-exclusion enabled (Settings) so your own clicks stop counting.

Still stuck? Contact us; include your site domain and what you tried.