Cloudflare Docs
Edit this page on GitHub
Set theme to dark (⇧+D)

Zaraz settings

To configure Zaraz’s general settings, select Zaraz > Settings. Make sure you save your changes, by selecting the Save button after making them.

​​ Workflow

Allows you to choose between working in Real-time or Preview & Publish modes. By default, Zaraz instantly publishes all changes you make in your account. Choosing Preview & Publish lets you test your settings before committing to them. Refer to Preview mode for more information.

​​ 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 E-commerce 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, becomes

  • 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:


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


​​ HTTP Events API

Refer to HTTP Events API for more information on this endpoint.

​​ Other

​​ Context Enricher

Refer to the Context Enricher for more information on this setting.