Getting Started

Installation Guide

Here is a quick guide to help you set up your Webalytics dashboard!

- 5 minuntes to complete
- No coding required
- Works on any platform

Before you start

Make sure you have the following ready:

You'll need

Finding Your Tracking Script

Your tracking script is unique to your website and it connects your site to your Webalytics dashboard. Here are two ways to find it.

HTML
<!-- Webalytics tracker -->
<script
  src="https://webalytics.ipxllc.net/tracker/tracker.js"
  data-api-key="YOUR-API-KEY-HERE"
  data-privacy-url="https://webalytics.ipxllc.net/privacy-policy/"
  defer
></script>
Do not use the script between different websites. Each site needs its own key.
1
Option 1 - From the Overview Page

After logging in, you'll land on your dashboard. Look for the "Get Tracker Script" button at the top of the page. Click it, then hit the green "Copy to clipboard" button to copy your script.

2
Option 2 - From Settings

Log in and go to Settings in the navigation. Scroll down until you see the Tracker Script section, then press the green "Copy to clipboard" button.

Platform-specific guides

Pick your platform for step-by-step instructions:

Option A - Using a plugin (recommended)

1
Install the "WPCode" plugin

In your WordPress admin go to Plugins ➔ Add New, search for WPCode - Insert Headers and Footers, then install and activate it.

2
Go to Code Snippets ➔ Header & Footer

In the left sidebar navigate to Code Snippets ➔ Header & Footer. Paste your Webalytics script into the Header box.

3
Click Save Changes

The script will now load on every page of your site automatically.

Option B - Manual (via theme editor)

Go to Appearance ➔ Theme File Editor ➔ header.php. Paste the script just before the closing </head> tag. Click Update File.

Manual edits to theme files will be overwritten when your theme updates. Use the plugin method above when possible, or use a child theme.
1
Open your Webflow Dashboard

Go to your Webflow dashboard and find your project. Click the three-dot menu (...) on your project thumbnail and select Settings.

2
Go to the Custom Code tab

In the left sidebar of Project Settings, click Custom Code.

3
Paste into the Head Code section

Paste your Webalytics script into the Head Code box. This applies it to every page on your site.

4
Save and Publish

Click Save Changes, then go back to the Designer and publish your site. Custom code only goes live after publishing.

1
Duplicate your theme first

Go to Online Store ➔ Themes. On your active theme click the three-dot menu (...) and select Duplicate. Always work on the duplicate to keep a safe backup.

2
Open the code editor on the duplicate

Click the three-dot menu (...) on the duplicated theme and select Edit code.

3
Open theme.liquid

In the file tree on the left, open Layout ➔ theme.liquid. This is the global file that applies to every page.

4
Paste before </head> and save

Find the closing </head> tag and paste your Webalytics script on the line directly above it. Click Save.

5
Publish the duplicate theme

Once you've confirmed everything looks right, go back to Online Store ➔ Themes and publish the duplicate to make it live.

Open each page's HTML file and paste the script just before the closing </head> tag.

HTML
<head>
  <!-- your existing head content -->
  <!-- Webalytics tracker -->
  <script
    src="https://webalytics.ipxllc.net/tracker/tracker.js"
    data-api-key="YOUR-API-KEY-HERE"
    defer
  ></script>
</head>
1
Go to Website ➔ Website Tools ➔ Code Injection

From your Squarespace dashboard, click Website in the left sidebar, then scroll down and click Website Tools, then select Code Injection.

2
Paste into the Header field

Paste your Webalytics script into the Header code injection area. Code added here loads on every page of your site.

3
Click Save

Changes go live immediately - no separate publish step needed.

Code Injection is only available on Squarespace Business and Commerce plans.

Verify it's working

Once your script is live, confirm it's tracking correctly:

Method 1 - Check your dashboard

What you should see

Visit your site, then go to your Webalytics dashboard. Within a few minutes you should see:

The number of "Total Visitors" should increase

Your site listed as Active in the Sites panel

Method 2 - Browser console

1
Open your site in an incognito window

Use incognito to avoid ad blockers or extensions that might interfere.

2
Open the browser console

Mac: Cmd + Option + J - Windows: Ctrl + Shift + J

3
Look for the confirmation message

You should see: Webalytics: tracking active

Troubleshooting

Not seeing data? Here are the most common causes:

Script installed but no data is appearing
Check that the script is present on the page. Resfresh the page and the right click page and press inspect. Search for "webalytics" and confirm that the site is using the correct script with the correct API key. Keys are site-specific and can be found in both the Overview & Settings tabs.
Script only on homepage, not other pages
The script must be included on every page you want to track. Add it to your global header template (header.php, theme.liquid, etc.) so it loads site-wide automatically.
Console shows an error or nothing at all
This often means a Content Security Policy (CSP) is blocking the script. Check your server config or Cloudflare settings and whitelist webalytics.ipxllc.net as a trusted script source.
Testing but still not seeing my visit
Always test in an incognito window with browser extensions disabled. Ad blockers (uBlock, Privacy Badger) can block tracking scripts.
I'm on a single-page app (SPA / React / Vue)
SPAs don't trigger a full page reload on navigation. Contact our support team for guidance on manually firing page events using the Webalytics JS API.

You're live - what's next?

Your tracker is installed. Here's how to get the most out of Webalytics:

Learn
Understanding your Conversion Grade
See how your grade is calculated and what each bucket means.
Learn
What gets tracked automatically
Webalytics captures clicks, form submits, scroll depth, and more - with no setup.
Action
Go to your dashboard
View your first visitors, check your grade, and see your top growth opportunities.
Learn
Setting up source attribution
Track which marketing channels are actually driving conversions.