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

# Visitors

> People who interact with your website chat widget, tracked and synced to records.

## Overview

The Visitors screen lists everyone who has interacted with your embeddable
[chat widget](/comms/chat/overview). Each visitor is tracked from the first
time the widget loads on your site, gets enriched when they share their
details, and can be automatically synced into a CRM object so chat traffic
becomes records you can work.

## How it works

When the widget loads, Custral records a visitor against a browser
fingerprint so a returning person resolves to the same entry instead of a
duplicate. New visitors start anonymous. They show as "Anonymous Visitor"
until a name, email, or phone is captured (typically through the widget's
intake form). The list shows the visitor's name or email, phone (if known),
and a "Last seen" date, and updates on each visit. Use the
search box to filter by name or email.

<Info>
  The list loads up to 50 visitors at a time and shows a total count in the tab label. Clicking a visitor opens their
  detail view.
</Info>

Sync-to-record is driven by the object you choose under **Sync Visitors to
Object** in your widget settings. When a visitor is identified, and again
before a widget conversation is created, Custral looks for a record matching
the visitor's email in that object. If one exists it updates that record's
email, phone, and name fields; if not, it creates a new record. The visitor
is then linked to that record. Sync only runs when the visitor has at least a
name or email, and chat still works even if a sync fails.

## Using it

<Steps>
  <Step title="Open Visitors">
    Go to **Visitors** in the app. Each row is a person who has loaded or chatted through your widget.
  </Step>

  <Step title="Find a visitor">Type a name or email into the search box to narrow the list.</Step>
  <Step title="Open a visitor's detail">Click a row to see the visitor's profile and their conversations.</Step>
</Steps>

## Troubleshooting

| Symptom                              | Likely cause                                                 | What to check                                                                    |
| ------------------------------------ | ------------------------------------------------------------ | -------------------------------------------------------------------------------- |
| "No visitors yet"                    | Widget not installed or not loading                          | Confirm the [widget install snippet](/comms/chat/widget-install) is on your site |
| Visitor shows as "Anonymous Visitor" | No name/email/phone captured yet                             | Visitor hasn't submitted the intake form or been identified                      |
| Same person appears twice            | Fingerprint changed (new device, cleared storage, incognito) | Expected. Returning-visitor matching is by browser fingerprint                   |
| Visitor not synced to a record       | Sync object not configured, or visitor has no name/email     | Verify the widget channel has a sync object set; sync needs a name or email      |
| Record created but missing fields    | Object lacks matching email/phone/name properties            | Check the target object's property types and keys                                |

<Note>
  When reporting an issue, include the request id shown in the error toast. It links the in-app error to the server
  logs.
</Note>

## Related

<CardGroup cols={2}>
  <Card title="Chat & Widget" href="/comms/chat/overview" icon="comment">
    How the chat widget works and hands off to a human.
  </Card>

  <Card title="Install the widget" href="/comms/chat/widget-install" icon="code">
    Add the widget script to your website.
  </Card>
</CardGroup>


## Related topics

- [widget.visitor.identified](/dev/webhooks/events/widget-visitor-identified.md)
- [Widget visitor identity](/dev/api-reference/widget-identity.md)
- [React SDK](/dev/sdks/react.md)
- [Chat & Widget](/comms/chat/overview.md)
- [Install the widget](/comms/chat/widget-install.md)
