Troubleshooting Guide

Solutions to common CookieBeam issues. If you can't find your answer, email [email protected]

Quick Jump:

Banner Display Issues Google Tag Manager Issues Consent Mode v2 Issues Cookie Scanning Issues Performance Issues

Banner Display Issues

Banner not showing on my website

Check if script is loaded

1. Open your website in Chrome
2. Press F12 to open Developer Tools
3. Go to the "Network" tab
4. Refresh the page
5. Search for "cookiebeam" in the filter
6. If you see a 200 status, the script loaded successfully

Verify Banner ID

1. Go to your CookieBeam dashboard
2. Click on your banner → Installation tab
3. Copy your Banner ID
4. Check that it matches the ID in your website code
5. Common mistake: Using the wrong ID or leaving "YOUR-BANNER-ID" placeholder

Check JavaScript errors

1. Open Chrome DevTools (F12)
2. Go to "Console" tab
3. Look for red error messages
4. If you see "CookieBeam is not defined" or similar, the script isn't loading
5. Try adding defer attribute: <script src="..." defer></script>

Clear cache

1. Hard refresh your browser: Ctrl+Shift+R (Windows) or Cmd+Shift+R (Mac)
2. Or clear browser cache completely
3. Try in incognito/private mode to test

Banner shows on desktop but not mobile

Check responsive settings

1. Go to Banner Designer → Layout
2. Ensure "Mobile Responsive" is enabled
3. Test different screen sizes in DevTools (F12 → Device Toolbar)
4. Check for conflicting CSS on mobile

Banner appears but looks broken/unstyled

CSS conflict

1. Your site's CSS might be overriding banner styles
2. Add !important priority in CookieBeam custom CSS
3. Or increase CSS specificity in banner settings
4. Check browser console for CSS errors

Banner shows every time I visit (not remembering choice)

Cookie storage issues

1. Check if your browser blocks third-party cookies
2. Verify localStorage is enabled (required for consent storage)
3. Check if you're in private/incognito mode (cookies don't persist)
4. Ensure consent cookie isn't being deleted by another script

Google Tag Manager Issues

Banner not firing in GTM Preview mode

Check tag configuration

1. Open GTM Preview mode
2. Look for "CookieBeam Consent" tag in the tag list
3. Verify it shows "Tags Fired" not "Tags Not Fired"
4. If not fired, check the trigger configuration
5. Use "Consent Initialization - All Pages" trigger

Tag firing but banner not appearing

1. Open browser console (F12)
2. Look for CookieBeam script loading
3. Check if Banner ID is correct in the GTM tag code
4. Verify the script URL is: https://cdn.cookiebeam.com/banner/...

Other tags still firing without consent

Configure consent requirements

1. Open each GA4/Google Ads tag in GTM
2. Go to Advanced Settings → Consent Settings
3. Enable "Require additional consent for tag to fire"
4. For GA4: Select "Analytics Storage"
5. For Google Ads: Select "Ad Storage" and "Analytics Storage"
6. Save and publish

Ensure CookieBeam loads first

1. CookieBeam tag must use "Consent Initialization" trigger
2. This fires BEFORE all other tags
3. Other marketing tags should have consent requirements

Performance Issues

Banner loading slowly

Optimize loading

1. Ensure script has "defer" attribute
2. Use CDN version (cdn.cookiebeam.com) not self-hosted
3. Check your internet connection speed
4. Banner should load in < 500ms on good connection

Banner blocking page load

Async loading

1. Always use defer or async attribute on script tag
2. Correct: <script src="..." defer></script>
3. Never load synchronously in <head>

Advanced Debugging

For developers: Use these browser console commands to debug CookieBeam

Check if CookieBeam loaded:

window.CookieBeam !== undefined

Get current consent state:

CookieBeam.getConsent()

Check dataLayer (GTM):

window.dataLayer

Force show banner (testing):

CookieBeam.show()

Reset consent (testing):

CookieBeam.reset()

Still Need Help?

If you couldn't find a solution here, we're here to help!

✉️ Email Support

[email protected]

Response within 24 hours

❓ FAQ

Common questions

Quick answers

📚 Learning Center

Guides & tutorials

In-depth documentation

📊 When reporting issues: Include your Browser ID (found in CookieBeam dashboard), browser version, and steps to reproduce the issue. Screenshots help too!