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

Enable Web Analytics

Cloudflare Web Analytics provides free, privacy-first analytics for your website without changing your DNS or using Cloudflare’s proxy. Cloudflare Web Analytics helps you understand the performance of your web pages as experienced by your site visitors.

All you need to enable Cloudflare Web Analytics is a Cloudflare account and a JavaScript snippet on your page to start getting information on page views and visitors. The JavaScript snippet (also known as a beacon) collects metrics using the Performance API, which is available in all major web browsers.

​​ Enable on Pages project

Cloudflare Pages offers a one-click setup for Web Analytics:

  1. Log in to Cloudflare dashboard.
  2. From Account Home, select Workers & Pages.
  3. In Overview, select your Pages project.
  4. Go to Manage > Web Analytics > and select Enable Web Analytics.

Cloudflare will automatically add the JavaScript snippet to your Pages site on the next deployment.

​​ View metrics

To view the metrics associated with your Pages project:

  1. Log in to Cloudflare dashboard.
  2. From Account Home, select Analytics & Logs > Web Analytics.
  3. Select the analytics associated with your Pages project.

For more details about how to use Web Analytics, refer to the Web Analytics documentation.

​​ Troubleshooting

For Cloudflare to automatically add the JavaScript snippet, your pages need to have valid HTML.

For example, Cloudflare would not be able to enable Web Analytics on a page like this:

Hello world.

For Web Analytics to correctly insert the JavaScript snippet, you would need valid HTML output, such as:

<!DOCTYPE html>
<p>Hello world.</p>