Content Security Policy (CSP) for the Sealmetrics tracker
A Content Security Policy tells the browser which hosts your pages may load scripts from and send data to. If your site uses one, this page lists exactly what Sealmetrics needs. Nothing else has to be allowed.
If the tracker is already being blocked and you are looking for the console errors, see Tracker blocked by CSP.
Minimum policy
The tracker needs two directives, both pointing to the host that serves t.js:
Content-Security-Policy: script-src 'self' https://t.sealmetrics.com; connect-src 'self' https://t.sealmetrics.com
| Directive | Why Sealmetrics needs it |
|---|---|
script-src https://t.sealmetrics.com | Loads the tracker (/t.js) and, on Shopify, the loader (/shopify-loader.js). |
connect-src https://t.sealmetrics.com | Sends pageviews, conversions and microconversions to /event with sendBeacon or fetch (and, when Agent Analytics is enabled, signals to /agent-signals on the same host). |
The tracker sets no cookies, opens no iframes, and loads no images, fonts or other scripts, so no other directive needs a Sealmetrics entry.
If you already have a policy, add the Sealmetrics host to your existing script-src and connect-src lists. Do not send a second Content-Security-Policy header: the browser enforces both, and a script must pass both to run.
Use the host you load the tracker from
Allow the host that appears in your snippet's src. Events are always sent to the same host that served t.js, so script-src and connect-src take the same host.
- Standard install:
https://t.sealmetrics.com. - First-party tracker on your own subdomain (for example
metrics.yourstore.com): allow that subdomain.'self'only matches the exact origin of the page, so a subdomain must be listed explicitly. - CMS plugin with the first-party proxy (WordPress, WooCommerce, PrestaShop, Magento 2, OpenCart, Joomla and Drupal):
t.jsand the events go through a path on your own site, so'self'covers them. Keephttps://t.sealmetrics.comin both directives anyway: if the proxy cannot be reached, the plugin falls back to loading the tracker directly from it.
Inline snippets need a nonce or hash
If your policy does not allow 'unsafe-inline', any inline <script> on the page is blocked unless it carries a nonce or matches a hash. That includes:
- the optional buffer stub (
window.sealmetrics.q) placed beforet.js; - inline calls such as
sealmetrics.conv('purchase', 49.90)on a thank-you page; - the loader our CMS plugins print in the page
<head>. It is an inline script without anonceattribute, so a nonce-based policy blocks it unless your CSP setup adds the nonce to it or allows it by hash.
Add the nonce your server already generates for the page:
<script nonce="RANDOM_PER_REQUEST">
sealmetrics.conv('purchase', 49.90);
</script>
The basic install, a single <script src="https://t.sealmetrics.com/t.js?id=YOUR_ACCOUNT_ID" defer></script> tag with no inline code, needs no nonce.
Google Tag Manager
If you load Sealmetrics through GTM, your policy must allow GTM itself, following Google's CSP guide for Tag Manager, in addition to the Sealmetrics host above. Custom HTML tags injected by GTM are inline scripts, so they need GTM's nonce-aware setup.
Shopify
- Public app (theme app embed): the loader and the tracker come from
https://t.sealmetrics.com. Allow it inscript-srcandconnect-srcif your theme sets a CSP. Most Shopify themes do not set one. The same applies to custom-app stores connected before October 2026, which load the same loader through a ScriptTag. - Custom app (Web Pixel): Shopify runs the pixel in its own sandbox, so your storefront CSP does not govern it.
See Shopify for which install your store uses.
Why there is no Subresource Integrity (SRI) hash
SRI (integrity="sha384-…") only works for a file that is byte-identical on every request. Each t.js response embeds a short-lived signed token that protects your data from spam and fake events. A new token is generated for each request, so the file's hash changes and an integrity attribute would block it.
The integrity of the tracker is protected on our side instead:
t.jsis compiled into our server software. Per site, only your account ID, the token and your snippet options are filled in. There is no per-site custom JavaScript stored anywhere, so a compromised dashboard account cannot change the code served on your site.- The minified tracker is built from its readable source in our repository, and our CI fails if the code the server ships differs from a fresh build of that source by a single byte. The served code cannot be changed without changing the source.
What a CSP does and does not protect
A CSP is defence in depth, and it is worth having:
- It does stop other scripts on your pages, including a compromised third-party tag, from loading code or sending data to hosts you did not list.
- It does make our privacy promise verifiable: the browser itself enforces that Sealmetrics can only send data to the host you allowed.
- It does not protect against a compromised
t.js, because the policy allows that file. That risk is covered by the controls described above.
Check your policy
- Open your site with the browser developer tools (Console tab).
- Look for
Refused to load the scriptorRefused to connectmessages that mention the Sealmetrics host. - In the Network tab, filter by
eventand check that requests to/eventreturn204.
To test a policy without breaking anything, send it first as Content-Security-Policy-Report-Only. The browser reports violations but blocks nothing.
Related
- Tracker blocked by CSP — symptoms and fixes when the policy is already blocking the tracker
- First-Party Tracker — serving the tracker from your own subdomain
- How Sealmetrics Reduces AdBlocker Data Loss — why first-party delivery matters