Skip to content

Widget

The CookieHub widget is the JavaScript consent banner embedded on customer websites.

Needs more detail

This page covers what's known from the infrastructure side. Widget build process, versioning, and CDN deployment details need input from the team.

Overview

The widget is a client-side JavaScript application that:

  • Displays the cookie consent banner to end users
  • Collects consent preferences (accept/deny per category)
  • Sends consent events to the edge layer for logging
  • Applies consent settings to control cookies and scripts on the page

Delivery

The widget is served via CDN. Customers embed it using an integration script generated per domain (available via GET /domains/:id/script in core-api).

Widget versions are managed per domain — each domain can pin to a specific version or track the latest stable release (configurable via PATCH /domains/:id/widget).

Dependencies

  • Edge layer — serves widget assets and handles consent event logging
  • Core API — provides domain configuration, consent settings, and widget version management