Documenting AI Audit metrics

Author: Oxyjun

src/content/docs/ai-audit/features/ai-crawler-detection.mdx

@@ -5,4 +5,25 @@ sidebar:
   order: 2
 ---
 
-TBC
+AI Audit metrics provides you with insight on how AI crawlers are interacting with your website.
+
+## View AI Audit metrics
+
+AI Audit provides you with the following metrics to help you understand how AI crawlers are interacting with your website.
+
+| Metric                                | Description                                                                   |
+| ------------------------------------- | ----------------------------------------------------------------------------- |
+| Total AI crawler requests             | The total number of requests to crawl your website, from all AI crawlers      |
+| Blocked requests                      | The number of requests you have blocked (by blocking AI crawlers)             |
+| Allowed requests                      | The number of requests you have allowed (by allowing AI crawlers)             |
+| Request by AI crawlers                | A graph which displays the number of crawl requests from each AI crawler      |
+| Most popular paths by AI crawlers     | The most popular pages crawled by AI crawlers, for each AI crawler            |
+| Hosts                                 | The owner of the AI crawler                                                   |
+| Overall popular paths                 | The most popular pages crawled by AI crawlers, from all AI crawlers           |
+| Most active AI crawlers by bot owners | The AI crawler owners with the highest number of requests to access your site |
+
+## Filter date range
+
+You can use the date filter to choose the period of time you wish to analyze.
+
+Click on the date filter dropdown and select the range of dates. The values of the AI Audit metrics will update according to your filter.

src/content/docs/ai-audit/get-started.mdx

@@ -12,7 +12,7 @@ description: Learn how to set up AI Audit.
 
 ---
 
-import { Render } from "~/components";
+import { Render, Steps } from "~/components";
 
 ## Prerequisites
 
@@ -23,26 +23,24 @@ import { Render } from "~/components";
 
 To enable AI Audit:
 
+<Steps>
 1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/), and select your account and domain.
 2. Go to **AI Audit**.
 3. From **AI Crawlers** tab, toggle **Block AI Crawlers**.
 4. From the **Bot traffic** page, under **Block AI Bots**, select **Enable**.
+</Steps>
 
-:::note[Enterprise customers]
-Customers on the Enterprise plan can choose to block only specific AI crawlers, while allowing others.
+## 2. Block specific AI crawlers (Enterprise plan only)
 
-In the **AI Crawlers** tab, block individual AI crawlers by toggling the switch under the **Block** column.
-:::
+Customers on the Enterprise plan can choose to only block specific AI crawlers, while allowing others.
 
-## 2. Review detected AI crawlers
+<Steps>
+1. Go to the **AI Crawlers** tab.
+2. Toggle the switch under the **Block** column for the AI crawlers you wish to block.
+</Steps>
 
-Review the AI crawlers detected on your site in the **Metrics** tab of the Cloudflare dashboard for key metrics. You can specify a time period, and view:
+## 3. Review detected AI crawlers
 
-- Number of total AI crawler requests
-- Number of blocked requests
-- Number of allowed requests
-- Number of review requests by each AI crawler
-- Most popular paths of your website by each AI crawler
-- Hosts (AI crawler owners)
-- Overall most popular paths in your website accessed by AI crawlers
-- Most active AI crawlers
+Review the AI crawlers detected on your site in the **Metrics** tab of the Cloudflare dashboard for key metrics.
+
+Refer to [AI crawler detection](/ai-audit/ai-crawler-detection/) for more information.

src/content/docs/ai-audit/index.mdx

@@ -3,13 +3,14 @@ title: AI Audit
 pcx_content_type: overview
 sidebar:
   order: 1
+  badge: Beta
 head:
   - tag: title
     content: Overview
 description: AI Audit is a tool which allows you to analyze and control how third-party AI crawlers interact with your website.
 ---
 
-import { Description, Feature, FeatureTable, Plan } from "~/components";
+import { Description, Feature, FeatureTable, Plan, LinkButton } from "~/components";
 
 <Description>
 
@@ -21,7 +22,11 @@ Analyze and control third-party AI crawlers in your website.
 
 AI Audit helps manage AI crawlers on your website by providing visibility on which crawlers are accessing your webpage, and allowing you to block unwanted crawlers.
 
-Learn how to [get started](/ai-audit/get-started/).
+<LinkButton href="/ai-audit/get-started/">Get started </LinkButton>
+
+:::note[Beta phase]
+AI Audit is currently only available as a beta product.
+:::
 
 ---
 

src/content/docs/ai-audit/release-notes.mdx

@@ -2,7 +2,7 @@
 pcx_content_type: changelog
 title: Release notes
 release_notes_file_name:
-  - d1
+  - ai-audit
 sidebar:
   order: 100
 ---

src/content/release-notes/ai-audit.yaml

@@ -3,7 +3,7 @@ link: "/ai-audit/changelog/"
 productName: AI Audit
 productLink: "/ai-audit/"
 productArea: Core platform
-productAreaLink: /core/reference/changelog/security/
+productAreaLink: /fundamentals/reference/changelog/platform/
 entries:
   - publish_date: "2025-06-09"
     title: Documentation for AI Audit