⏱4 min readUpdated August 2026
Troubleshooting & FAQ
Solutions for banner visibility issues, regional routing questions, and theme conflicts.
Here are solutions to the most common questions and troubleshooting scenarios encountered when setting up WS Cookie Consent.
Banner is not showing on storefront#
- Check if you have already accepted or rejected cookies in your current browser session. Use an Incognito window to test afresh.
- Verify that the Theme App Embed is toggled on and saved in your active Shopify theme.
- If Regional Targeting is enabled (e.g. EU only) and you are testing from outside the EU, enable Test Mode in the app settings.
How do visitors change their preferences?#
You can enable the subtle floating Privacy Choices corner button in the app settings, or link any custom button/link in your footer using data-ws-consent-open:
html
<!-- Custom Footer Preference Link -->
<a href="#privacy" data-ws-consent-open class="footer__link">
Manage Cookie Preferences
</a>Resolving z-index or styling overlaps#
If your sticky header or third-party live chat widget overlaps the cookie banner, navigate to Settings > Banner Customization in the WS Cookie Consent admin and adjust the Z-Index Layer slider (default: 999999).
Have feedback or question about this guide?
Our commerce engineering studio provides direct developer assistance.