Cloudflare Docs
Zaraz
Cloudflare Docs
Zaraz
Search icon (depiction of a magnifying glass)
GitHub icon
Visit Zaraz on GitHub
Set theme to dark (⇧+D)

Zaraz settings

To configure Zaraz’s general settings, select Zaraz > Settings.

​​ Web API

​​ Debug Key

The debug key is used to enable Debug Mode. Refer to Debug mode for more information.

​​ E-commerce tracking

Toggle this option on to enable the Zaraz E-commerce API. Refer to Ecommerce for more information.

​​ Compatibility

​​ Data layer compatibility mode

Cloudflare Zaraz offers backwards compatibility with the dataLayer function found in tag management software, used to track events and other parameters. You can toggle this option off if you do not need it. Refer to Data layer compatibility mode for more information.

​​ Single Page Application support

When you toggle Single Page Application support off, the pageview trigger will only work when loading a new web page. When enabled, Zaraz’s pageview trigger will work every time the URL changes on a single page application. This is also known as virtual page views.

​​ Privacy

Zaraz offers privacy settings you can turn on, such as:

  • Remove URL query parameters: Removes all query parameters from URLs. For example, https://example.com/?q=hello becomes https://example.com/.

  • Trim IP addresses: Trims part of the IP address before passing it to server-side loaded tools, to hide it from third-parties.

  • Clean User Agent strings: Clear sensitive information from the User Agent string by removing information such as operating system version, extensions installed, among others.

  • Remove external referrers: Hides the page referrers URL if the hostname is different from the website’s.

​​ Injection

​​ Auto-inject script

This option automatically injects the script needed for Zaraz to work on your website. It is turned on by default.

If you turn this option off, Zaraz will stop automatically injecting its script on your domain. If you still want Zaraz functionality, you will need to add the Zaraz script manually. Refer to Load Zaraz manually for more information.

​​ Iframe injection

When toggled on, the Zaraz script will also be injected into iframe elements.

​​ Endpoints

Specify custom URLs for Zaraz’s scripts. You need to use a valid pathname:

/<PATHNAME>/<FILE.JS>>

This is an example of a custom pathname to host Zaraz’s initialization script:

/my-server/my-scripts/start.js