Installation
Add one script tag to your website to start tracking. No cookies, no consent banners, no complex setup. The whole process takes about a minute.
Step 1: Get your tracking snippet
After you add a site in Clickport, you'll see this screen with your personal tracking snippet ready to copy:
Click the copy icon to grab the snippet. Your domain is already filled in automatically.
Step 2: Paste it into your website
Open the HTML of your website and paste the snippet inside the <head> tag. It should look something like this:
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>My Website</title>
<!-- Clickport Analytics -->
<script defer data-domain="yoursite.com"
src="https://clickport.io/tracker.js"></script>
</head>
<body>
...
</body>
</html>
The defer attribute means the script loads in the background without slowing down your page. Your visitors won't notice any difference in load time.
Step 3: Verify it works
Back in your Clickport dashboard, open Settings (gear icon → Site settings). The first tab, "Site & Tracking snippet", shows your tracking snippet and a "Verify installation" button:
Click "Verify installation" and Clickport will check your page, your published Google Tag Manager container, and your recent visits for the tracker. If everything is set up correctly, you'll see a green confirmation message. Because it inspects your Tag Manager container too, a tracker added through Google Tag Manager is recognized even though it never appears in your page's static HTML.
Exclude yourself from tracking
You probably don't want your own visits showing up in the analytics. Open Settings (gear icon → Site settings → Tracking rules) and flip the "Exclude this device" toggle at the top:
Flip it once per device and your visits are hidden from then on, even if your IP address changes (mobile networks, Wi-Fi switching, VPN). See Exclude Your Visits for the full guide.
Platform guides
The snippet works the same way on any platform. Here's where to paste it on popular ones:
WordPress
Use the Clickport WordPress connector for the easiest setup. It adds the tracker automatically and lets you exclude logged-in admins. Alternatively, paste the snippet into your theme's header.php file or use a plugin like "Insert Headers and Footers."
Shopify
Go to Online Store, then Themes. Click the three-dot menu and choose "Edit code." Open theme.liquid and paste the snippet inside the <head> tag.
Squarespace
Open the Code Injection panel (under Website Tools) and paste the snippet into the "Header" field. Full guide: Squarespace.
Webflow
Go to Site settings, then Custom code. Paste the snippet into the "Head code" field and publish. Full guide: Webflow.
Framer
Open your project Settings, then Custom Code. Paste the snippet into the "End of <head> tag" section and publish. Full guide: Framer.
Google Tag Manager
Create a Custom HTML tag with the snippet and fire it on Initialization - All Pages. A direct install is more reliable when you have the choice. Full guide: Google Tag Manager.
Wix
Go to Settings, then Custom Code, add the snippet to the Head, applied to all pages with "Load code once". Needs a connected domain. Full guide: Wix.
Ghost
Go to Settings, then Advanced, then Code injection, and paste the snippet into Site Header. Full guide: Ghost.
Next.js
Add a Script component with the snippet to your root layout. Route changes are tracked automatically. Full guide: Next.js.
Static site generators (Hugo, Jekyll, Astro, etc.)
Add the snippet to your base layout or template file inside the <head> section. It will then be included on every generated page. For Hugo specifics: Hugo.
Single-page applications
If your site is built with React, Vue, Next.js, Angular, or any other SPA framework, the tracker handles it automatically. It detects client-side navigation and counts each page change as a new pageview. No extra configuration needed.
For more details, see SPA Tracking.
Subdomains
If you have subdomains like blog.yoursite.com or shop.yoursite.com, they'll all roll up under the same site automatically. Just use data-domain="yoursite.com" on each subdomain. Clickport matches subdomains to the parent domain.
Troubleshooting
No data appearing
- Make sure
data-domainmatches the domain you registered in Clickport (withouthttps://or trailing slash) - The tracker auto-disables on
localhostand127.0.0.1to prevent test traffic. You need to deploy it to a real URL. - Check that the snippet is only included once per page (duplicates can cause issues)
- Open your browser's developer console (F12) and look for any errors
Script blocked by ad blocker
Most ad blockers allow Clickport since it doesn't use cookies or fingerprinting. If yours blocks it, you can proxy the script through your own domain. See Script Configuration for setup instructions.