← Docs home

Add Pinfox to a static HTML website

If your site is plain HTML (no framework—just .html files), add Pinfox with a single script tag in the <head> of each page (or in a shared header/include if you use one).

Step 1: Add the script to your HTML

Open your HTML file(s) and paste the Pinfox script just before the closing </head> tag:

<script
  defer
  src="https://freemium.pinfox.io/analytics.js"
  data-site-id="YOUR_WEBSITE_ID"
></script>

Replace YOUR_WEBSITE_ID with your Website ID from the Pinfox Dashboard (add a site there to get the ID).

Example page

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>My Website</title>
    <script
      defer
      src="https://freemium.pinfox.io/analytics.js"
      data-site-id="YOUR_WEBSITE_ID"
    ></script>
  </head>
  <body>
    <h1>Welcome</h1>
  </body>
</html>

Multiple pages

For a site with many HTML pages, add the same script to the <head> of every page you want to track. If you use a static site generator (e.g. Jekyll, Hugo, 11ty) or a shared header partial, include the script there so it appears on all pages.

Verify installation

After adding the script:

  • Upload your files and open your site in a browser.
  • Check your Pinfox dashboard for incoming pageviews. It may take a minute or two for the first events to appear.

Static HTML Best Practices

Cross-Page Tracking

Ensure the Pinfox script is present on EVERY page of your static site. If you're using a static site generator (SSG) like Jekyll, Hugo, or Eleventy, add the script to your base layout or partial template to ensure consistent tracking across your entire domain.

Why choose Pinfox for your analytics?

Privacy-First & Cookieless

Pinfox doesn't use cookies or any form of persistent tracking. We respect your visitors' privacy and help you comply with GDPR, CCPA, and PECR without needing annoying cookie banners.

Ultra-Lightweight Script

Our tracking script is less than 1KB. It won't slow down your site or affect your Core Web Vitals. Keep your site fast while getting the insights you need.

Real-Time Data Streams

See your traffic as it happens. Our real-time dashboard updates instantly, allowing you to see the immediate impact of your marketing efforts and launches.

No Data Sampling

Unlike Google Analytics, we never sample your data. You get 100% accurate reporting, regardless of how much traffic your website receives.

Frequently Asked Questions

Do I need a cookie banner with Pinfox?

No. Since Pinfox doesn't use cookies and doesn't collect personal data, you don't need to display a cookie consent banner for analytics purposes. This improves your user experience and conversion rates.

Can I track custom events?

Yes! Pinfox supports custom event tracking. You can track button clicks, form submissions, and other user interactions to better understand how visitors engage with your site.

Is Pinfox compatible with SPA frameworks?

Absolutely. Pinfox is built to work seamlessly with modern frameworks like React, Vue, Angular, Next.js, and more. It automatically handles client-side routing and virtual pageviews.

Metrics we track

  • Unique Visitors
  • Total Pageviews
  • Referrer Sources
  • Top Pages & Content
  • Geographic Location
  • Device & Browser Info