# Add CLItrail to Plain HTML

Where the CLItrail tag goes in Plain HTML, in its own idiom, with the consent, CSP and client-side routing details and how to check it works.

Written for Any static site

## Where the tag goes

Edit `The <head> of every page (for example index.html and install.html), or the shared header include`. Put the tag on every page that shows your install command; site-wide is best, after your existing analytics tags.

```html
<head>
  <meta charset="utf-8" />
  <!-- …your analytics tags first -->
  <script defer src="https://YOUR_SERVICE/browser.js" data-website="YOUR_WEBSITE_ID"></script>
</head>
```

## Only after consent

Use the loader in place of the tag: nothing from CLItrail loads until `startClitrail()` runs. Load the loader before your consent manager's script and call `startClitrail()` from the manager's accept callback (most managers also run it on later visits once a choice is stored; check yours). Use the marketing category when installs go to Google Ads, Meta, TikTok or X Ads, and the analytics category when they only reach GA4 or your webhooks.

Consent loader

```js
// Loads CLItrail only after the visitor agrees. Call startClitrail() from your
// consent manager's "accepted" callback; nothing is fetched or stored before that.
window.startClitrail = () => {
  if (document.getElementById('clitrail')) return;
  const tag = document.createElement('script');
  tag.id = 'clitrail';
  tag.src = 'https://YOUR_SERVICE/browser.js';
  tag.dataset.website = 'YOUR_WEBSITE_ID';
  document.head.append(tag);
};
```

```html
<head>
  <meta charset="utf-8" />
  <!-- …your analytics tags first -->
  <script defer src="/clitrail-consent.js"></script>
  <!-- …then your consent manager's script -->
</head>
```

## Client-side routing

Every page is a full page load, so the tag records each page by itself. Nothing else to add.

## Content Security Policy

Your host's header settings (for example `_headers` on Cloudflare Pages or Netlify, `vercel.json`, or your server), or a `<meta http-equiv="Content-Security-Policy">` tag: add `https://YOUR_SERVICE` to `script-src` and `connect-src`, and `blob:` to `worker-src` (only Safari before 26 needs that one).

```
script-src 'self' https://YOUR_SERVICE;
connect-src 'self' https://YOUR_SERVICE;
worker-src 'self' blob:;
```

## Verify it works

1. Deploy the pages, or serve them locally (for example `npx serve .`).
2. Open a page with the tag in Chrome or Firefox (accept analytics first if you gate CLItrail on consent), open the developer console and run `await InstallAttribution.ready`. It resolves to `{ ok: true, urlId, hasAnalyticsContext, expiresAt }`.
3. In the CLItrail dashboard, open Visits & identities: the visit is listed.
4. Anything else names the cause: `disabled` (no consent yet, or `data-enabled="false"`), `opfs_unavailable` (the page is not served over https or from localhost), `Error` (the service refused the visit: add the page's origin, including a development origin such as `http://localhost:3000`, under Settings → Additional domains). If `InstallAttribution` is undefined, the tag did not load: check the Network tab and your Content-Security-Policy.

Then run your installer on the same computer and check **Install events**, or run the hook with [`--doctor`](https://clitrail.com/docs/doctor).

## Notes

- Keep `defer` and `data-website`: the SDK reads its settings from its own `<script>` element.
- Put it after your analytics tags, so it can read their IDs.
- Site-wide is best: the landing page carries the campaign. The pages that show your install command are the minimum.

Plain HTML documentation: [developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/script](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/script)

Using other install paths or destinations? The [setup generator](https://clitrail.com/docs/setup-generator) puts this snippet together with your hooks and destination checklist.
