Resources · Installation

Install TickAI in minutes

Install, configure and verify in four short steps. However your site is built, it's the same idea: paste one small snippet, then style your badges from the dashboard.

Overview

Installing TickAI is the same on every platform — you add one snippet to your site's <head>. It loads asynchronously (no slowdown), never edits your source files, and you can remove it any time to remove every badge.

Create a free account and add your site under Sites.
Open Settings → Install and copy your unique snippet — it looks like this (your real one has your project and site ID filled in):

<script
  src="https://app.tickai.app/overlay.js"
  data-config="https://<your-project>.supabase.co/storage/v1/object/public/badge-configs/<your-site-id>.json"
  async
></script>

The data-configURL points at a small file we keep up to date with the badges you've approved — the snippet itself never needs changing again.

How to install

Pick your platform — each just needs the snippet pasted into the right place.

Shopify

Option A — Theme app embed (recommended)

In Shopify admin: Online Store → Themes → Customize.
Open App embeds, find TickAI and toggle it on. Save.

The one-click app embed is coming soon. Until then, use Option B.

Option B — Edit theme code (works today)

Online Store → Themes → ⋯ → Edit code.
Open layout/theme.liquid and paste your snippet just before </head>.
Save. (Tip: duplicate your theme first if you'd like a backup.)

WordPress & WooCommerce

Option A — Header-scripts plugin (easiest)

Install a plugin such as WPCode or Insert Headers and Footers.
Paste your snippet into the plugin's “Header” box. Save.

Option B — Theme header

In a child theme, edit header.php and paste the snippet before </head>.

WooCommerce stores are just WordPress — either option works.

Wix

In your Wix dashboard: Settings → Custom Code.
Click + Add Custom Code and paste your snippet.
Set Place Code in: Head, apply to All pages, load it once, then Apply.

Squarespace

Settings → Advanced → Code Injection.
Paste your snippet into the Header box and Save.

Code Injection is available on Business and Commerce plans.

Any other site (custom, or via GTM)

For a custom-built site, paste the snippet into the <head> of every page (usually a shared header template or layout file).

Using Google Tag Manager? Create a Custom HTML tag, paste the snippet, and set it to fire on All Pages.

Using an AI agent?

If you build or maintain your site with an AI coding assistant (Claude, Cursor, Copilot, etc.), copy the prompt below and paste it to your agent. Swap in your data-config URL from Settings → Install first.

You are helping install the "TickAI" disclosure widget on my website.

Task: add the following script tag to the <head> of every page — ideally in the shared site-wide layout, header template, or theme header so it loads on all pages. Insert it just before the closing </head> tag. Do not modify, remove, or reformat any other code.

<script
  src="https://app.tickai.app/overlay.js"
  data-config="PASTE_YOUR_DATA_CONFIG_URL_HERE"
  async
></script>

Notes:
- Replace PASTE_YOUR_DATA_CONFIG_URL_HERE with the data-config URL from my TickAI dashboard (Settings → Install). Keep the rest exactly as-is.
- If the site uses Google Tag Manager, instead create a Custom HTML tag containing this snippet and set it to fire on All Pages.
- The script must load on every page, only once.

When done: tell me exactly which file(s) you changed and how to deploy/publish the change.

The agent only adds one script tag to your header — it never needs access to your TickAI account.

How to configure

Once installed, you control how disclosures look and where they appear — all from your dashboard, no code. Your snippet never changes; updates apply automatically.

Turn on the overlay

In Settings, switch on “Apply badges live on my site”. Nothing appears publicly until this is on, so you can review everything in private first. (Available on paid plans.)

How your badges look

Two official labels are applied automatically — AI Generated for fully synthetic content and AI Modified for substantially altered real content.

For the style, keep “Auto-pick the best style” on and we choose the most legible of the four official styles (black, white, or transparent) for each image — or force a single style to match your brand.

Per-image control

You're always in control per image. When you review an asset you confirm its label (AI Generated vs AI Modified), which decides the icon shown — and nothing goes live until you've approved it.

EU-only badges

Prefer to show badges only to EU visitors? Turn on EU geo-targeting in Settings (Pro and above). Region is resolved at the edge and no visitor data is stored.

How to complete

Verify it works

Approve at least one asset for disclosure in your dashboard.
Visit a page on your live site that shows that image — the badge appears within a minute or two (CDN propagation).
Not showing? Check the snippet is in the <head> on that page and that serving is enabled in Settings.

Troubleshooting

Badges aren’t appearing

Check three things: serving is enabled (Settings), the asset's decision is approved, and you've given it a minute or two for the CDN to refresh. Also confirm the snippet is in the <head> of that page.

The snippet is in but nothing happens

Make sure the data-config URL is exactly the one from Settings → Install — a single typo breaks the lookup. Open that URL in your browser; it should return JSON, not an error.

A badge sits in the wrong place or overlaps content

Badges anchor to the top-right of each image. A heavily customised theme can shift that — tell us the page and we'll help position it.

I only want badges shown to EU visitors

Turn on EU geo-targeting in Settings (Pro and above). It resolves region at the edge and stores no visitor data.

A Content Security Policy (CSP) is blocking the script

Allow our script and config domains in your CSP — add them to script-src and connect-src.

I removed the snippet — is anything left behind?

No. Removing the snippet removes every badge immediately; it never modified your files, so there's nothing else to clean up.