Verify your installation
Confirm the Yokaify widget is installed correctly, and fix the most common install problems.
The 30-second check
- Open your site in a private/incognito window (so no stale cache or extensions interfere).
- The mascot should appear within a couple of seconds of page load.
- In the Yokaify dashboard, open Setup — install detection flips to confirmed the moment the widget successfully phones home from your domain.
If the mascot doesn't appear
Work down this list — it covers nearly every real-world case:
1. Origin not allowed
The most common cause. The domain serving the page must be in your site's allowed origins list (dashboard → Settings). Remember that www.yourstore.com, yourstore.com, staging domains, and localhost are all different origins. See Site keys & allowed origins.
2. Wrong or missing site key
View the page source and find the script tag. data-site-key must exactly match the key shown in your dashboard. A snippet copied from another site (or the docs placeholder YOUR_SITE_KEY) won't mount.
3. Script never loads
Open your browser's developer tools → Network tab, reload, and search for widget.js.
- Missing entirely — the snippet isn't in the served HTML. Check you edited the right template/theme and published.
- Blocked or 4xx — an optimization plugin, Content-Security-Policy, or ad blocker is interfering. Allow
cdn.yokaify.com(script) and your API origin in your CSP, and exclude the script from JS bundling plugins.
4. Two copies of the snippet
Search the page source for data-site-key. If it appears twice (e.g. a plugin and a manual paste), remove one.
5. Consent manager gating
If your cookie-consent tool blocks scripts until acceptance, the mascot will only appear after consent. That may be exactly what you want — just be aware of it while testing.
Still stuck?
See the full troubleshooting guide, or contact support from the dashboard — include your site key and the page URL you tested.