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

> ## Agent Instructions
> Read /start/capabilities before choosing an integration. Use the deployed server’s tools/list for current tool inputs.

# Troubleshooting

> Find why a change is not appearing.

Start with installation and selectors, then check the decision.

| Problem | Check |
| - | - |
| No installation check-in | Script, workspace ID, consent, exact origin |
| No changes | Published release, pause/holdout, page registration |
| Target missing | Selector matches exactly one rendered element |
| Variant never selected | Requirements and visitor context |
| Selection returned but not applied | Timing, interaction, focus, visibility |
| Styling changed after import | Saved HTML, import warnings, site CSS |
| Results empty | Live mode, goal name, internal-traffic flag, collect requests |
| Write conflict | Reread the workspace and use its current version |

## Inspect the runtime

```js theme={null}
const state = window.IONVisitor?.inspect();
console.log({
  phase: state?.status.phase,
  message: state?.status.message,
  experiment: state?.experiment,
  receipt: state?.status.receipt,
});
```

This is an internal debugging API. A missing controller can be expected before consent or a usable live configuration.

Check a selector separately:

```js theme={null}
document.querySelectorAll('[data-personalize="proof"]').length;
document.querySelector('[data-personalize="proof"]')?.getAttribute('data-ion-variant');
```

> [accordion] More specific cases
>
> * **`/site` returns 403:** verify the exact origin, live release, and billing access.
> * **Decision returns 409:** reload the current configuration; site ID or revision differs.
> * **Order works only in manual preview:** the list may already be visible or interacted with.
> * **Quiz answers have no effect:** completion tracking does not send answers; check the connector mapping and cache.
> * **Purchase gate fails live:** browser purchase claims are stripped; a trusted integration is required.
> * **MCP tool is missing:** check `tools/list`, endpoint, and permissions.
> * **Preview disconnects after deployment:** reconnect; preview sessions are process-local.

For timing and cache behavior, see [Script lifecycle](https://docs.usedynamite.com/internals/script-lifecycle.md). When reporting a bug, include the page, target, release revision, mode, and a redacted receipt.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.