Troubleshooting installation
If the banner doesn't appear after installing the script, this page covers the most common causes and fixes.
The banner doesn't appear at all
Confirm the script is on the page. Open the website, right-click and choose View Source (or press Ctrl/Cmd + U). Search for oneprivacy. If you don't see the snippet in the page source, the script wasn't added correctly.
Use a fresh browser session. Browser caches sometimes hide a newly added script. Open the website in an incognito or private window and try again.
Check that your banner is published to Live. In One Privacy, open Customization and confirm the banner has a Live version. If you only saved a draft, the banner won't appear on production. See Publishing to Live.
Confirm the snippet is for the right environment. The Test snippet only works with banners published to Test. The Production snippet only works with banners published to Live.
Wait a moment. The script loads asynchronously. Give it a couple of seconds.
The banner appears, but on every page reload
This is expected for visitors who haven't accepted yet. Once a visitor clicks Accept, Reject, or saves preferences from the popup, the banner won't show again until they reopen it via the floating button.
Check that cookies are not blocked. One Privacy stores the visitor's choice in a cookie. Browsers in strict privacy modes can block this. Test in a regular incognito window first.
The wrong banner is showing
Check your geo rules. If you have multiple banners and geo rules, make sure the rule for your test region points to the right banner. See Creating a geo rule.
Confirm the right version was published. The Live version of your banner is what real visitors see. If you only Published to Test, real visitors won't see the change. See Publishing to Live.
Old content is still showing
Clear your CDN or page cache. If your website is behind a cache (Cloudflare, Shopify, WP cache plugins), changes to the page can take a few minutes to propagate. Purge your cache and try again.
Hard refresh the browser. Press Ctrl+Shift+R (Windows) or Cmd+Shift+R (Mac).
The banner overlaps something on my site
Adjust the margins. In Customization, expand the Layout accordion and add margin space. See Layout and position.
Switch position. If you have a chat widget in the bottom right, try Bottom Left for the banner. See Layout and position.
Cookies are still firing before consent
Check the order of scripts in your page. The One Privacy snippet should load before any tracking scripts. If GTM or another tag manager loads first, One Privacy can miss its chance to control consent.
For more, see Cookies firing before consent.
Consent records aren't appearing in the audit
See Consent not recorded.