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

# Pixel Tracking

> Track visitor analytics and build profiles before they start chatting

<Info>
  **Plan availability:** Standard or higher. See [Plans & Billing](/features/settings/plans).
</Info>

## What Pixel Tracking Does

When pixel tracking is enabled, the Clarky widget on your website acts like a lightweight analytics tool — similar to HubSpot or other visitor intelligence platforms. It quietly observes how people use your site so your agent has rich context the moment they start a conversation, and so you can review traffic trends in the [Traffic dashboard](/features/traffic/overview).

Pixel tracking captures:

<CardGroup cols={2}>
  <Card title="Page Views" icon="eye">
    Every page a visitor views on your website.
  </Card>

  <Card title="Widget Interactions" icon="hand-pointer">
    When visitors open, close, or interact with the chat widget.
  </Card>

  <Card title="Visitor Profiles" icon="user">
    Comprehensive profiles built across multiple sessions.
  </Card>

  <Card title="UTM Attribution" icon="chart-line">
    First-touch and last-touch marketing attribution.
  </Card>

  <Card title="Geographic Data" icon="globe">
    IP-based country, region, and city.
  </Card>

  <Card title="Device Information" icon="desktop">
    Browser, OS, screen size, and connection type.
  </Card>
</CardGroup>

## Enabling Pixel Tracking

<Steps>
  <Step title="Open Pixel Tracking settings">
    Go to **Settings > Traffic > Pixel Tracking**.
  </Step>

  <Step title="Toggle it on">
    Flip the **Pixel Tracking** switch. The status badge updates to **Enabled** and tracking begins on the next page load.
  </Step>

  <Step title="Review the Traffic dashboard">
    Visit the [Traffic dashboard](/features/traffic/overview) to see incoming page views, visitor profiles, and attribution data.
  </Step>
</Steps>

You can disable pixel tracking at any time by toggling the switch off. New page views stop being recorded immediately, but historical data is preserved unless you delete it explicitly (see [Blocked Paths](#blocked-paths)).

## Blocked Paths

Some pages shouldn't be tracked — admin areas, internal staging routes, or pages where tracking would be inappropriate. Blocked paths let you exclude specific URLs or URL patterns from analytics.

### Adding a Blocked Path

<Steps>
  <Step title="Enter a path or pattern">
    In the **Blocked Paths** section, type a path into the input field. Paths must start with `/` (a literal path) or `*` (a wildcard pattern).
  </Step>

  <Step title="Click Block">
    The path is added to the list and immediately excluded from tracking.
  </Step>
</Steps>

### Pattern Examples

<AccordionGroup>
  <Accordion title="Block a section of your site">
    `/admin/*` blocks `/admin`, `/admin/users`, `/admin/settings`, and any other path under `/admin`.
  </Accordion>

  <Accordion title="Block all internal pages">
    `/internal/*` blocks every URL beginning with `/internal/`.
  </Accordion>

  <Accordion title="Block paths ending with a suffix">
    `*/preview` blocks any URL ending in `/preview` — useful for content preview routes.
  </Accordion>

  <Accordion title="Block paths containing a keyword">
    `*staging*` blocks any URL that contains the word "staging" anywhere in the path.
  </Accordion>
</AccordionGroup>

### Removing a Blocked Path

Click the **X** icon next to a path to remove it from the block list. Tracking resumes for matching pages on the next visit.

### Deleting Existing Data

Adding a blocked path stops *future* tracking — it does not retroactively remove data. If you want to clear historical analytics for a path you've blocked, click **Delete Data** next to it. Clarky will permanently remove all page views matching that pattern.

<Warning>
  Deleting analytics data cannot be undone. Make sure you really want to remove the historical record before confirming.
</Warning>

## Privacy Considerations

Pixel tracking collects visitor data — including IP addresses for geolocation — that may be regulated in your jurisdiction.

<Warning>
  Make sure your privacy policy reflects this data collection. Depending on where your visitors are located, you may need to obtain consent under regulations such as GDPR or CCPA before tracking is enabled.
</Warning>

For controls on what your agent stores about individual users (email, phone, name), see [Privacy Settings](/features/settings/privacy).

<Card title="Open the Traffic dashboard" icon="chart-line" href="/features/traffic/overview">
  See the visitor data you've collected.
</Card>

<Card title="Back to Settings" icon="gear" href="/features/settings/overview">
  Return to Settings overview
</Card>