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

# Widget Troubleshooting

Diagnose install, display, identity, messaging, and runtime issues.

# Widget Troubleshooting

Use this checklist when the widget does not appear, cannot send messages, or does not recognize a visitor.

## Widget Does Not Appear

1. Confirm the script URL loads:

   ```txt
   https://api.rogeriq.com/widget/v1/rogeriq.js
   ```

2. Confirm `RogerIQ("init", { projectId })` runs after the queue stub exists.
3. Check browser console errors.
4. Confirm the project ID belongs to the expected RogerIQ project.
5. Confirm widget `enabled` is true in Settings -> Widget.
6. Check display settings such as `display.style: "manual"`.

## Messages Do Not Send

Check:

- `messagingEnabled` is true
- the project exists
- the widget API is reachable
- required contact fields are supplied
- file attachments pass size and type checks
- the conversation was not ended

## Identity Is Not Verified

Check:

- secure mode is enabled only when you can generate signatures server-side
- the email passed to `identify` exactly matches the email used for signing
- the signature is lowercase hex
- the secret was not rotated without updating your server

## SPA Page Context Is Missing

Call `RogerIQ("event", { type: "page-viewed", ... })` on route changes.

## Local Debugging

```js
const info = RogerIQ("info");
console.table(info.state);
console.table(info.visitor);
```