> ## Documentation Index
> Fetch the complete documentation index at: https://docs.taginsight.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Finding and fixing tracking issues

> Simple guide to identify and resolve tracking problems

## Overview

When tracking isn't working correctly, Tag Insight provides simple tools to help you identify and fix issues quickly. This guide shows you how to find problems without needing technical expertise.

<Note>
  Most tracking issues can be identified and fixed in under 15 minutes using Tag Insight's visual tools.
</Note>

## Your debugging toolkit

<CardGroup cols={2}>
  <Card title="Live Debugger" icon="bug">
    See what's happening on your website in real-time
  </Card>

  <Card title="Chrome Extension" icon="chrome">
    Visual overlay showing tracking on your pages
  </Card>

  <Card title="Audit Reports" icon="file-alt">
    Detailed reports of tracking issues found
  </Card>

  <Card title="Data Layer Collector" icon="database">
    Historical view of your tracking data
  </Card>
</CardGroup>

## Using the Live Debugger

The Live Debugger shows you exactly what tracking data is being collected as you browse your website.

### Getting started

<Steps>
  <Step title="Open Live Debugger">
    In your Tag Insight dashboard, click **Live Debugger** from the menu
  </Step>

  <Step title="Visit your website">
    Open your website in a new browser tab
  </Step>

  <Step title="Browse normally">
    Click around your site as a normal visitor would
  </Step>

  <Step title="Watch events appear">
    See tracking events appear in real-time in the debugger
  </Step>
</Steps>

### Understanding what you see

Each event in the debugger shows:

* **Event name**: What action was tracked (e.g., "Product Viewed")
* **Status icon**:
  * ✅ Green = Everything is correct
  * ⚠️ Yellow = Minor issues (like optional data missing)
  * ❌ Red = Critical issues that need fixing
* **Timestamp**: When the event happened
* **Details**: What data was collected

### Common issues to look for

<AccordionGroup>
  <Accordion title="Missing events">
    If you performed an action but don't see it in the debugger:

    * The tracking might not be set up for that action
    * There might be a delay (wait 5-10 seconds)
    * Try refreshing the debugger page
  </Accordion>

  <Accordion title="Red error indicators">
    These mean required information is missing:

    * Click on the event to see what's missing
    * Share the error details with your developer
    * Common missing data: transaction IDs, product IDs, prices
  </Accordion>

  <Accordion title="Yellow warning indicators">
    These are usually less critical:

    * Optional information is missing
    * Data format might be slightly wrong
    * Can often be fixed later
  </Accordion>
</AccordionGroup>

## Using the Chrome Extension

The Tag Insight Chrome Extension adds a visual layer to your website showing what's being tracked.

### Installation and setup

<Steps>
  <Step title="Install the extension">
    Go to the Chrome Web Store and search for "Tag Insight"
  </Step>

  <Step title="Pin the extension">
    Click the puzzle piece icon in Chrome and pin Tag Insight
  </Step>

  <Step title="Visit your website">
    The extension automatically activates on your tracked sites
  </Step>
</Steps>

### What the extension shows

* **Green highlights**: Elements that are properly tracked
* **Red highlights**: Elements that should be tracked but aren't
* **Event badges**: Small labels showing what events fire when clicked
* **Validation status**: Real-time checking of your tracking

## Common tracking problems

### "I don't see any events"

<Steps>
  <Step title="Check installation">
    Verify Tag Insight is installed (ask your developer)
  </Step>

  <Step title="Check the right project">
    Make sure you're looking at the correct Tag Insight project
  </Step>

  <Step title="Clear browser cache">
    Sometimes old code gets stuck - clear cache and try again
  </Step>

  <Step title="Try a different browser">
    Test in Chrome, Firefox, or Safari to rule out browser issues
  </Step>
</Steps>

### "Events show errors"

When you see red errors in the debugger:

1. **Click on the event** to see error details
2. **Take a screenshot** of the error information
3. **Note what you were doing** when the error occurred
4. **Share with your developer** or Tag Insight support

### "Some pages aren't tracked"

This usually means:

* Tag Insight isn't installed on those pages
* The pages use a different tracking setup
* There's a technical issue preventing tracking

**Solution**: Share the list of untracked pages with your technical team.

## Creating useful bug reports

When you find an issue, help your team fix it faster by providing:

<Card title="Bug Report Template">
  **What happened**: Describe the issue in simple terms

  **When it happened**: Date, time, and what page you were on

  **What you expected**: What should have happened instead

  **Steps to reproduce**:

  1. Go to \[specific page]
  2. Click on \[specific button]
  3. Fill in \[specific information]
  4. See error

  **Screenshots**: Include screenshots from the debugger

  **Browser details**: Chrome, Safari, Firefox, etc.
</Card>

## Working with your technical team

### Information they need

When reporting issues to developers, include:

* Screenshot of the Live Debugger showing the error
* The exact URL where the problem occurs
* What you clicked or did before the error
* Any error messages you see

### Questions to ask

* "Is Tag Insight installed on all our pages?"
* "Are we tracking all the events in our tracking plan?"
* "When was tracking last working correctly?"
* "Have there been recent website changes?"

## Quick fixes you can try

Some issues can be resolved without technical help:

<AccordionGroup>
  <Accordion title="Clear your browser data">
    Settings → Privacy → Clear browsing data → Cached images and files
  </Accordion>

  <Accordion title="Disable browser extensions">
    Ad blockers or privacy extensions can interfere with tracking
  </Accordion>

  <Accordion title="Try incognito/private mode">
    This rules out issues with your browser profile
  </Accordion>

  <Accordion title="Check your internet connection">
    Slow connections can cause timeouts
  </Accordion>
</AccordionGroup>

## Getting help

If you can't resolve an issue:

1. **Check the FAQ** - Common issues and solutions
2. **Contact support** - [support@taginsight.com](mailto:support@taginsight.com)
3. **Schedule a demo** - Get personalized help
4. **Ask your implementation partner** - They know your specific setup

## Best practices

### Regular checks

* **Weekly**: Spend 10 minutes in the Live Debugger
* **After website updates**: Always verify tracking still works
* **When issues are reported**: Check immediately

### Document issues

* Keep a log of recurring problems
* Note when issues started
* Track which issues are resolved

### Team communication

* Share debugging findings with your team
* Create a shared document for tracking issues
* Schedule regular reviews with your developer

## Next steps

<CardGroup cols={2}>
  <Card title="Common Issues" icon="exclamation-triangle" href="/troubleshooting/common-issues">
    Solutions to frequent tracking problems
  </Card>

  <Card title="Chrome Extension" icon="chrome" href="/tools/chrome-extension">
    Learn more about the visual debugging tool
  </Card>

  <Card title="Live Debugger" icon="bug" href="/tools/live-debugger">
    Master real-time debugging
  </Card>

  <Card title="FAQ" icon="question" href="/troubleshooting/faq">
    Quick answers to common questions
  </Card>
</CardGroup>