Debug mode

Last updated Apr 16, 2026 Zaraz offers a debug mode to troubleshoot the events and triggers systems. To activate debug mode you need to create a special debug cookie (zarazDebug) containing your debug key. You can set this cookie manually or via the zaraz.debug helper function available in your console.

  1. In the Cloudflare dashboard, go to the Settings page. Go to Settings ↗
  2. Copy your Debug Key.
  3. Open a web browser and access its Developer Tools. For example, to access Developer Tools in Google Chrome, select View > Developer > Developer Tools.
  4. Select the Console pane and enter the following command to create a debug cookie:

js zaraz.debug("YOUR_DEBUG_KEY")

Zaraz’s debug mode is now enabled. A pop-up window will show up with the debugger information. To exit debug mode, remove the cookie by typing zaraz.debug() in the console pane of the browser.

Was this helpful?

YesNo

On this page

Debug mode - 图1Docs

{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/zaraz/web-api/debug-mode/#page","headline":"Debug mode","description":"Enable Zaraz debug mode to inspect events in the browser console.","url":"https://developers.cloudflare.com/zaraz/web-api/debug-mode/","inLanguage":"en","image":"https://developers.cloudflare.com/zaraz/web-api/debug-mode/og.png?v=42f7f1c2f0aed2de","dateModified":"2026-04-16","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}}

description: Send e-commerce events like purchases and cart updates through Zaraz. title: E-commerce image: https://developers.cloudflare.com/zaraz/web-api/ecommerce/og.png?v=2c7517243c712967

Skip to content

Documentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/zaraz/llms.txt
Use this file to discover all available pages before exploring further.