Installation

Installing Pipetrace on your website takes less than a minute. Choose the method that works best for your setup.

Basic Installation

Add the following script tag to your website's <head> section:

<script 
  defer 
  data-site="YOUR_TRACKING_ID" 
  src="https://api.pipetrace.com/t.js"
></script>

Replace YOUR_TRACKING_ID with the tracking ID from your dashboard.

Framework-Specific Instructions

Next.js

Add the script to your app/layout.tsx or pages/_document.tsx:

// app/layout.tsx
import Script from 'next/script'

export default function RootLayout({ children }) {
  return (
    <html>
      <head>
        <Script
          defer
          data-site="YOUR_TRACKING_ID"
          src="https://api.pipetrace.com/t.js"
        />
      </head>
      <body>{children}</body>
    </html>
  )
}

React (Vite/CRA)

Add the script to your index.html:

<!DOCTYPE html>
<html>
  <head>
    <script 
      defer 
      data-site="YOUR_TRACKING_ID" 
      src="https://api.pipetrace.com/t.js"
    ></script>
  </head>
  <body>
    <div id="root"></div>
  </body>
</html>

WordPress

Add the script using the Header & Footer Scripts plugin, or add it to your theme's header.php file.

Shopify

Go to Online Store → Themes → Edit code, find theme.liquid, and add the script inside the <head> tag.

Verify Installation

After adding the script:

  1. Visit your website in a new browser tab
  2. Go to your Pipetrace dashboard
  3. Check the "Live" counter - you should see 1 visitor

Troubleshooting

Script not loading?

  • Check that the tracking ID is correct
  • Ensure the script is in the <head> section
  • Disable ad blockers temporarily to test
  • Check browser console for errors

No data showing?

  • Data may take a few seconds to appear
  • Ensure the domain matches what you registered
  • Check that JavaScript is enabled