Troubleshooting

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

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

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:

document.querySelectorAll('[data-personalize="proof"]').length;
document.querySelector('[data-personalize="proof"]')?.getAttribute('data-ion-variant');

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. When reporting a bug, include the page, target, release revision, mode, and a redacted receipt.

Start here

Install & integrate

Build experiences

Work with agents

Measure & operate

Inspect the runtime

​Inspect the runtime

Inspect the runtime