1. Developer-Reference
  • Getting-Started
    • CYBEXO Developer Documentation
    • Quickstart (5 to 10 Minutes)
    • Documentation Overview
    • Concepts and Glossary
  • Compliance-and-Standards
    • Compliance Overview
    • IAB TCF v2.3 Support
    • Google Consent Mode v2 Validation
    • TCF API Validation
    • Audit Checklist (Pre-Launch)
  • Web-and-CMS-Integrations
    • CYBEXO CMP SDK – Web & GTM Setup
    • Integrate CYBEXO CMP with Webflow and Wix
    • Integrate CYBEXO CMP with WordPress
    • Integrate CYBEXO CMP with Drupal
    • Integrate CYBEXO CMP with Shopify
  • Mobile-SDKs
    • CYBEXO CMP SDK - iOS Setup
    • iOS SDK API Reference
    • CYBEXO CMP SDK - Android Setup
    • Android SDK API Reference
    • App Attribution Partner (AAP) Integrations
  • Developer-Reference
    • Web JS API Reference
    • Consent Event Schema
    • Deployment and Environments
    • CYBEXO Debug Tool
    • Troubleshooting Playbook
    • Performance and Best Practices
    • Accessibility and UX Guidelines
    • Localization Workflow
    • Migration Guide
  • Security-and-Privacy
    • Security Overview
    • Privacy Architecture
    • Data and Logging Transparency
    • Subprocessors
    • CSP and Network Allowlist
  • Enterprise-and-Legal
    • DPA and Legal Pack
    • RFP Feature Matrix
    • Status and Reliability
    • Support and Escalation
    • CYBEXO CMP SDK – Commercial Licence
  • Operations
    • Changelog and Version Policy
  1. Developer-Reference

Troubleshooting Playbook

Last updated: February 18, 2026
This playbook provides symptom -> cause -> verification -> fix guidance.

1. Banner Not Showing#

Symptoms:
no banner visible on first visit
Root causes:
invalid settings ID
script blocked by CSP or ad blocker
loader script placed too late or removed by optimizer
How to confirm:
Fix:
verify settings ID
allowlist required domains
ensure script is present exactly once in page source

2. Tags Fire Before Consent Default#

Symptoms:
analytics/ads tags execute before consent configuration
Root causes:
CMP tag not on Consent Initialization trigger
duplicate tag configuration
How to confirm:
Fix:
move CMP tag to Consent Initialization
remove conflicting consent commands

3. Consent Not Updating After User Action#

Symptoms:
user interacts with banner but no update seen
Root causes:
JS error interrupts callback
blocked network request
stale cached script
How to confirm:
check browser console errors
inspect network requests to CMP API endpoint
Fix:
resolve runtime errors
clear cache and republish
validate API reachability

4. Duplicate Banner#

Symptoms:
two banners appear
Root causes:
plugin + manual script both active
theme embed + app embed both enabled
How to confirm:
Fix:
keep only one integration path

5. TCF API Missing#

Symptoms:
window.__tcfapi undefined
Root causes:
script not loaded
broken execution order
blocked third-party resource
How to confirm:
Fix:
verify script and CSP
validate page-level script ordering

6. What to Send Support#

Settings ID
production URL
screenshots
console output
debug report from CYBEXO Debug Tool
Previous
CYBEXO Debug Tool
Next
Performance and Best Practices