6 min read

Wix Integration

Add privacy-focused, cookieless-capable analytics to your Wix site in under five minutes. Zenovay works on Wix Free, Premium, and Business / VIP plans, with deeper hooks available for Wix Velo developers.

The fastest path is Settings → Custom Code → Head. You need a Wix Premium plan or higher to use Custom Code.

Quick Start

Step	Where	What you do
1	Zenovay dashboard	Copy your tracking snippet
2	Wix admin → Settings → Custom Code	Paste the snippet into a new Head code element
3	Publish your site	Click Publish to deploy the change
4	Zenovay dashboard	Wait 1–2 minutes, then check real-time visitors

Method 1: Custom Code (Recommended)

Wix Custom Code lets you inject any HTML snippet into the <head> of every page. It's the same approach Wix recommends for Google Analytics and Meta Pixel.

Step-by-step

Open your Wix site in the editor or dashboard.
Go to Settings (gear icon, left sidebar) → Custom Code.
Click + Add Custom Code.
Paste the Zenovay snippet from your dashboard:

<script defer data-tracking-code="YOUR_TRACKING_CODE" src="https://api.zenovay.com/z.js"></script>

Configure the placement:
- Add Code to Pages: All pages → Load code on each new page
- Place Code in: Head
- Name: Zenovay Analytics (so you can find it later)
Click Apply.
Click Publish at the top of the editor — Custom Code only runs on the published site, not in preview.

Verify the install

Open your published site in an incognito window and view the page source (Cmd/Ctrl+U). Look for the line <script defer data-tracking-code=.... Then open the Zenovay real-time view — your own visit should appear within ~30 seconds.

Method 2: Wix Velo (for developers)

If your site uses Wix Velo (formerly Corvid) and you need to track router pages, dynamic page transitions, or member-only events, install Zenovay through Velo instead. This gives you access to the full window.zenovay() event API.

Add the script via Velo

In the Velo Dev Mode of your site, open masterPage.js and add:

import wixWindow from 'wix-window';

$w.onReady(() => {
  if (wixWindow.rendering.env !== 'browser') return;

  const s = document.createElement('script');
  s.defer = true;
  s.src = 'https://api.zenovay.com/z.js';
  s.setAttribute('data-tracking-code', 'YOUR_TRACKING_CODE');
  document.head.appendChild(s);
});

Track custom events

After the script loads you can fire events from any Velo page:

$w('#submitButton').onClick(() => {
  if (window.zenovay) {
    window.zenovay('track', 'lead_form_submitted', {
      form_id: 'homepage-cta',
      plan_interest: $w('#planDropdown').value,
    });
  }
});

Identify members

If you use Wix Members, you can attach a stable visitor ID:

import { currentMember } from 'wix-members';

currentMember.getMember()
  .then(member => {
    if (member && window.zenovay) {
      window.zenovay('identify', {
        userId: member._id,
        email: member.loginEmail,
        name: member.profile?.nickname,
      });
    }
  });

Tracking Wix-specific events

Wix feature	How to track
Contact form submit	Set up a custom event via Wix Automations or Velo `onWixFormSubmit`
Wix Stores purchase	Use the revenue API with the order webhook, or fire `window.zenovay('track', 'purchase', { revenue, currency })` from the thank-you page
Wix Bookings appointment	Velo `wix-bookings-backend` server event → call our server-side tracking API
Newsletter signup	Velo `onWixFormSubmit` on the signup form, fire `window.zenovay('track', 'signup', { source: 'newsletter' })`

Plan requirements & limits

Wix Free: Custom Code is not available. You must upgrade to Premium ($16/mo or higher) for any third-party script.
Wix Premium (Combo, Unlimited, Pro): Custom Code works on all pages.
Wix Business / VIP: Custom Code + Wix Velo + server-side hooks available.
Wix Studio (the newer editor): Custom Code lives under Site Settings → Tracking & Analytics → + New Tool. Choose Custom and paste the same snippet into the Head slot.

Common gotchas

Snippet only fires on the published site. Wix Custom Code is intentionally stripped from the preview/editor. If you don't see traffic, make sure you clicked Publish and you're testing the live URL (not editor.wix.com).

Caching delay. Wix caches the published HTML aggressively. After publishing, allow 5–10 minutes before declaring the install broken — and force-refresh with Cmd/Ctrl+Shift+R when testing.

Wix Studio uses a different menu. In Wix Studio (rolled out in 2024) the path is Settings → Tracking & Analytics, not Custom Code. The snippet itself is identical.

SPA navigation isn't auto-tracked on all themes. Wix renders most pages as full server-side templates, so default pageview tracking works. If you use a Velo router or a heavily SPA-style template, call window.zenovay('trackPageView') manually on route change.

Don't double-install. If you previously pasted the snippet into the theme via a Wix App and are now using Custom Code, you'll count each visit twice. Pick one method.

Troubleshooting

Symptom	Likely cause	Fix
No data in dashboard	Site not published	Click Publish in the editor
No data in dashboard	Custom Code targeting only specific pages	Re-check Add Code to Pages → All pages
Duplicate pageviews	Snippet pasted in both Custom Code and theme	Remove one
Data only on some pages	Load on first page only selected	Change to Load code on each new page
Real-time view empty but Network tab shows `/event` 200	Ad-blocker on your own browser blocking the dashboard call	Test in incognito with extensions off

Privacy & compliance

Zenovay's tracker is cookieless-capable. If you're embedding on a regulated site (EU/UK/CH/Brazil/California), you can opt into cookieless mode by adding data-cookieless="true" to the script tag:

<script defer
        data-tracking-code="YOUR_TRACKING_CODE"
        data-cookieless="true"
        src="https://api.zenovay.com/z.js"></script>

In this mode no cookies or local storage entries are written — visitor IDs live only for the current tab. See the Privacy Compliance guide for full detail.

Need help? Contact [email protected] or visit our Help Center.