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://www.tickai.co/api/badge-overlay"
  data-config="https://<your-project>.supabase.co/storage/v1/object/public/badge-configs/<your-site-id>.json"
  async
></script>

The data-config URL 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 - Edit theme code (works today)

In Shopify admin, go to Online Store -> Themes.
Find the theme you want TickAI installed on. If you want a safety backup first, duplicate the theme before editing it.
On that theme, click ... and choose Edit code.
In the left-hand file list, open layout/theme.liquid. This is usually the shared layout file for the whole storefront.
Find the closing </head> tag and paste your TickAI snippet immediately above it.
Click Save.
Open your storefront and, if you want to double-check, view page source to confirm the snippet now appears inside the page <head>.

If you are unsure which Shopify file to use, start with layout/theme.liquid because it usually loads across the whole theme.

Option B - Theme app embed

In Shopify admin, go to Online Store -> Themes -> Customize.
Open App embeds, find TickAI, and toggle it on.
Save your changes.

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

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, go to 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

Go to 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 in 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, you can let it do the install. The quickest way is in the app: open Settings -> Install and click "Copy agent instructions" - you'll get a ready-made prompt with your site's real snippet already filled in.

Prefer to copy from here? Use the prompt below and 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://www.tickai.co/api/badge-overlay"
  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. After it's done, deploy or publish your site and turn on the overlay in Settings so approved badges appear.

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 style, keep "Auto-pick the best style" on and we choose the most legible of the four official styles 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, 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 are not 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.

The test says the site is blocked or protected

Some sites block automated server-to-server checks even when the page is live. If you use Cloudflare, a WAF, or bot protection, confirm the snippet is present in page source on your homepage and then test in a normal browser tab.

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 https://www.tickai.co in script-src and connect-src. Also allow https://*.supabase.co in connect-src so the overlay can fetch your config JSON.

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.