HeyCatch Help heycatch.ai

Install analytics on Wix

It takes about 5 minutes: you paste one piece of code into your Wix site settings and check that events are coming in.

Before you start

  1. Your site needs a paid Wix plan and a connected domain. Custom code is not available on free Wix sites.
  2. Your site must already be published.
  3. You need your HeyCatch project key. It starts with hck_pk_.

1. Find your project key

Your project key starts with hck_pk_. Before your first install is confirmed it sits on the Analytics, Install screen in the sidebar; once an install is confirmed it sits behind the gear icon in the top right of the Product page. Press Copy prompt, paste the text into a note and copy just the key, from hck_pk_ to its last character. If a full stop follows the key, leave it out.

2. Copy this code

Replace YOUR_PROJECT_KEY with your key and keep the quotes:

<script type="module">
  import { analytics } from 'https://esm.sh/@heycatch/sdk@0.8.0';
  analytics.init({
    projectKey: 'YOUR_PROJECT_KEY',
    requestBatching: false,
    install: { framework: 'wix', agent: 'other' },
  });
</script>

3. Add it in Wix

  1. Open your site's dashboard in Wix.
  2. Go to Settings, then Custom Code, in the Development & integrations section.
  3. Press + Add Custom Code.
  4. Paste the code.
  5. Give it a name, like HeyCatch.
  6. Under Add Code to Pages, choose All pages, and pick Load code once.
  7. Under Place Code in, choose Head.
  8. Press Apply.

4. Visit your live site

Open your live site in a normal browser and click around for a few seconds. Visits from bots, scripts and automated browsers are filtered out, so it has to be you, clicking.

5. Check in HeyCatch

Back in HeyCatch, on the screen where you copied the prompt, press "I've installed" within the next half hour. The check only counts events from the last 30 minutes, so do it straight after your visit.

Not seeing events?

  1. Is your domain connected? Wix runs custom code only on sites with a paid plan and a connected domain.
  2. Is the key right? It starts with hck_pk_ and sits inside the quotes, with no extra spaces.
  3. Is it set to All pages and Head? Not a single page, and not the body.
  4. Did you visit the live site yourself? Not the editor preview, and not a testing tool.

Still stuck? Write to us in the chat and we will look at your site.

Short links are a separate step. Each link needs one redirect rule on your site, from /i to /?utm_campaign=i for each letter you use. Wix has a redirect screen for this. The Short links article explains the rule.

Last updated 2026-10-05 · support@heycatch.ai