Sitetooling.space Logo/Docs

Quickstart Guide

Get SiteTooling.space up and running on your website in under 5 minutes.

Before You Begin

What You'll Need

  • Access to edit your website's HTML code
  • A SiteTooling.space account (sign up at sitetooling.space)
  • Your tracking token from the dashboard

Step-by-Step Setup

1

Sign Up & Get Your Token

Create your free account at sitetooling.space and grab your unique tracking token from the dashboard.

Your Dashboard Token

TOKEN:st_1234567890abcdef1234567890abcdef

⚠️ Keep this token secure and don't share it publicly

2

Add the Tracking Script

Copy the script below and paste it into your website's <head> section, replacing YOUR_TRACKING_TOKEN with your actual token.

Tracking Script

<script async defer src="https://sitetooling.space/track.js" data-token="YOUR_TRACKING_TOKEN"></script>

Important

Make sure to replace YOUR_TRACKING_TOKEN with your actual token from step 1.

3

Verify Installation

After adding the script, visit your website to generate your first page view. Data should appear in your dashboard within minutes.

What to Check

  • • Script loads without errors
  • • Page views register in dashboard
  • • Real-time data appears
  • • Mobile pages are tracked

Troubleshooting

  • • Check for JavaScript errors
  • • Verify token is correct
  • • Wait up to 10 minutes for data
  • • Try in incognito mode

Platform-Specific Examples

Here are specific instructions for popular website platforms:

WordPress

  1. Go to your WordPress admin → Appearance → Theme Editor
  2. Select your active theme and open header.php
  3. Insert the tracking script before the closing </head> tag
  4. Save the file and clear any caching plugins

Pro tip: Consider using a header/footer plugin to avoid losing the script when updating themes.

Static HTML/CSS

  1. Open your HTML file in a text editor
  2. Locate the <head> section
  3. Paste the tracking script before </head>
  4. Repeat for all pages or use a template/partial

Best practice: Add the script to a shared header template if you're using a static site generator.

React/Next.js

For Next.js projects, add the script to your _document.js or _app.js:

import Head from 'next/head'
    
    export default function MyApp({ Component, pageProps }) {
        return (
        

            <Head>
            <script 
                async
                defer
                src="https://sitetooling.space/track.js"
                data-token="YOUR_TRACKING_TOKEN"
            />
            </Head>
            <Component {...pageProps} />
        

        )
    }

Shopify

  1. Go to your Shopify admin → Online Store → Themes
  2. Click "Actions" → "Edit code" on your active theme
  3. Open theme.liquid file
  4. Insert the tracking script before </head>
  5. Save the file

Note: The script will automatically track all pages, including checkout flows.

Optional: Display Analytics on Your Site

Want to show your site analytics publicly? Add our analytics display script to create a live stats widget.

Analytics Display Script

JavaScript:

<script src="https://sitetooling.space/analytics.js" data-token="YOUR_TRACKING_TOKEN" data-element="site-analytics"></script>

HTML Container:

<div id="site-analytics"></div>

Fallback (No JavaScript):

<noscript> <img src="https://sitetooling.space/noscript.gif?token=YOUR_TRACKING_TOKEN" alt="sitetooling.space" /> </noscript>

Analytics Display Info

The analytics display script will show a live widget with your site's current stats. Perfect for showcasing transparency or site popularity.

Verification & Testing

Browser Console Check

  1. Open your website in a new browser tab
  2. Press F12 or right-click → "Inspect Element"
  3. Go to the "Console" tab
  4. Look for any JavaScript errors
  5. Check if the script loads successfully

Success: No errors in console and network tab shows successful requests to sitetooling.space

Dashboard Verification

  1. Visit your SiteTooling.space dashboard
  2. Navigate to the "Overview" section
  3. Wait up to 10 minutes for data to appear
  4. Check for recent page views and visitor data
  5. Verify real-time tracking is working

Tip: Try visiting your site in incognito mode to test tracking without affecting your own browsing data

Common Issues & Solutions

What's Next?

🎉 Congratulations! Your tracking is now live.

Now that SiteTooling.space is tracking your website, here are some recommended next steps to get the most out of your analytics:

Have questions or need help? Contact our support team or check out our GitHub discussions.