Skip to content

Bots: Content Independence Day 2026 — new taxonomy, AI presets, Attribution Business Insights#31793

Open
jinhee-c-lee wants to merge 8 commits into
productionfrom
cid-2026-bots-taxonomy
Open

Bots: Content Independence Day 2026 — new taxonomy, AI presets, Attribution Business Insights#31793
jinhee-c-lee wants to merge 8 commits into
productionfrom
cid-2026-bots-taxonomy

Conversation

@jinhee-c-lee

@jinhee-c-lee jinhee-c-lee commented Jun 30, 2026

Copy link
Copy Markdown
Collaborator

Documentation updates for Content Independence Day 2026, aligned to the "Your site, your rules: new AI traffic options for all customers" blog (source of truth).

Changes

  • Verified bots (/bots/concepts/bot/verified-bots/): redefine "verified" as honest self-identification + non-abusive behavior; a verified bot is now allowable through its behavior category (baselines take effect September 15, 2026); add Direct vs Intermediary labels.
  • Deprecate "signed agents": removed from the sidebar and 301-redirected /bots/concepts/bot/signed-agents (and /*) → /bots/concepts/bot/verified-bots/; inbound links repointed.
  • AI bots (/bots/concepts/bot/#ai-bots): behavior-based Search / Agent / Training classification. The options to manage AI traffic are available now; new defaults are enforced on September 15, 2026 (Training and Agent blocked on pages with ads, Search allowed). On Sept 15, multi-purpose crawlers that combine Search + Training (Googlebot, Applebot, Bingbot) are blocked when blocking Training; customers can opt out before Sept 15.
  • Block AI Bots page updated to the Search/Agent/Training options and the Sept 15 defaults.
  • New page: BotBase (/bots/botbase/), ordered between Bot Analytics and Attribution Business Insights; registered its dashboard route. (Attribution Business Insights and Account Abuse Protection sidebar.order bumped accordingly.)
  • New page: Attribution Business Insights (/bots/attribution-business-insights/).
  • Glossary + verified-bots partial updates; redirect-format and stale-link fixes for CI.

Notes

  • Opening for review; please do not merge until docs owners have reviewed.

- Redefine Verified bots (honest + non-abusive) and add Direct/Intermediary labels
- Deprecate Signed agents classification (pages kept as deprecation notices)
- Rewrite AI bots section: Training/Search/User presets, pages-with-ads defaults
- Update Block AI bots page to the new presets
- Add Attribution Business Insights section (between Bot Analytics and Account Abuse Protection)
- Glossary + verified-bots partial updates
- Add 301 redirects: /bots/concepts/bot/signed-agents(/*) -> /bots/concepts/bot/verified-bots/
- Delete signed-agents index + policy pages (removes them from the auto-generated sidebar)
- Repoint inbound links (bot-verification, web-bot-auth, bot-management-variables, fields) to verified bots
- Document Block Training (all) vs Block Training (only if it doesn't affect search)
- Note the latter is equivalent to the legacy Block AI bots option
- Call out Googlebot, Applebot, and Bingbot as the 3 tracked bots that do not
  separate their crawler: included in Block Training (all), excluded from
  Block Training (only if it doesn't affect search)
…d Definitions

- Remove subtitle + 'for decades' framing paragraphs
- Tighten intro; add 24h/7d/30d time windows
- Reframe Availability as visibility-only; link Security rules and AI bot mitigation options
- Update Access dash deep-link and zone-level navigation path
- Remove What you can see / Per-operator view / How it relates sections
- Add Definitions section (content pages, crawl-to-referral ratios, classification, action)
@jinhee-c-lee jinhee-c-lee requested review from a team, elithrar and marinaelmore as code owners June 30, 2026 03:51
@cloudflare-docs-bot

cloudflare-docs-bot Bot commented Jun 30, 2026

Copy link
Copy Markdown
Contributor

Review

⚠️ 1 warning, 💡 8 suggestions found in commit 97c9fc3.

Code Review

This code review is in beta and may not always be helpful — use your judgment.

No code review issues found.

Conventions

Checks PR title, description, and redirect checklist.

No convention issues found.

Style Guide Review

Warnings (1)
File Issue
bots/concepts/bot/index.mdx line 51 Heading begins with -ing verb — Heading starts with Managing AI traffic Fix: Change to Manage AI traffic
Suggestions (8)
File Issue
bots/concepts/bot/index.mdx line 55 Time-sensitive content: month name and four-digit year outside changelog — Heading contains September 15, 2026 Fix: Remove or rewrite without the month and year reference
bots/concepts/bot/index.mdx line 57 Time-sensitive content: month name and four-digit year outside changelog — Prose contains September 15, 2026 Fix: Remove or rewrite without the month and year reference
bots/concepts/bot/index.mdx line 62 Time-sensitive content: month name outside changelog — Prose contains September 15 Fix: Remove or rewrite without the month reference
bots/additional-configurations/block-ai-bots.mdx line 29 Time-sensitive month reference — :::note[New defaults on September 15, 2026] Fix: Remove the month reference or rewrite the note to be timeless.
bots/additional-configurations/block-ai-bots.mdx line 29 Time-sensitive year reference — :::note[New defaults on September 15, 2026] Fix: Remove the year reference or rewrite the note to be timeless.
bots/additional-configurations/block-ai-bots.mdx line 30 Time-sensitive month reference — Added prose contains 'September 15, 2026' Fix: Rewrite without the month reference.
bots/additional-configurations/block-ai-bots.mdx line 30 Time-sensitive year reference — Added prose contains 'September 15, 2026' Fix: Rewrite without the year reference.
bots/additional-configurations/block-ai-bots.mdx line 30 Use DashButton for dashboard deeplinks — Direct dash.cloudflare.com markdown link for opting out of defaults Fix: Use instead of a direct link.

Redirects

No missing redirect entries found.

Commands

Only codeowners can run commands. Post a comment with the command to trigger it.

Command Description
/review Runs a review now. Incremental if a prior review exists, full if not.
/full-review Re-reviews the entire PR diff from scratch, ignoring incremental history. Useful after a rebase, when you want a fresh review, or if the bot gets out of sync and reports issues that no longer exist.
/ignore-review-limit Permanently lifts the 2-review automatic limit for this PR. Future pushes will trigger reviews as normal.
/disable-auto-review Stops automatic reviews from triggering on future pushes to this PR. Codeowners can still run /review or /full-review manually.

@github-actions github-actions Bot added product:bots Related to Bots product size/m labels Jun 30, 2026
@github-actions

Copy link
Copy Markdown
Contributor

This PR changes current filenames or deletes current files. Make sure you have redirects set up to cover the following paths:

  • /bots/concepts/bot/signed-agents/
  • /bots/concepts/bot/signed-agents/policy/

@github-actions

github-actions Bot commented Jun 30, 2026

Copy link
Copy Markdown
Contributor

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/public/__redirects @cloudflare/content-engineering, @cloudflare/product-owners
/src/content/changelog/ @cloudflare/pm-changelogs, @cloudflare/product-owners
* @cloudflare/product-owners
/src/content/docs/bots/ @jinhee-c-lee, @cloudflare/appsec-reviewers, @elithrar, @cloudflare/product-owners, @marinaelmore, @njustus1

@ask-bonk

ask-bonk Bot commented Jun 30, 2026

Copy link
Copy Markdown
Contributor

Here is the review for PR #31793.


Summary

This is a well-structured documentation PR that updates the Bots product for the Content Independence Day 2026 (July 1) launch. The changes accurately reflect the new taxonomy (Direct vs. Intermediary), deprecate the standalone "signed agent" concept, introduce behavior-based AI bot presets (Training / Search / User), and add the new Attribution Business Insights page. Frontmatter, sidebar ordering, glossary additions, and dashboard deep-link registration all look correct.

Labels applied: product:bots, size/m
Suggested additional label: launch/cid-2026 or do-not-merge (per PR note to block merging until docs owners review).


Issues requiring attention

1. Redirect source missing trailing slash (CI failure risk)

File: public/__redirects

The first redirect line lacks the required trailing slash on the source path. Per repo conventions, source URLs in public/__redirects must end in / (or *, .xml, .json, .html).

-/bots/concepts/bot/signed-agents /bots/concepts/bot/verified-bots/ 301
+/bots/concepts/bot/signed-agents/ /bots/concepts/bot/verified-bots/ 301

2. Stale internal link in changelog (will 404 after merge)

File: src/content/changelog/browser-run/2026-03-10-br-crawl-endpoint.mdx (line 11)

This changelog still links to /bots/concepts/bot/signed-agents/, which is deleted by this PR. Update it to point to the new verified-bots page.

-The endpoint is a [signed-agent](https://developers.cloudflare.com/bots/concepts/bot/signed-agents/) that respects robots.txt
+The endpoint is a [verified bot (intermediary agent)](https://developers.cloudflare.com/bots/concepts/bot/verified-bots/) that respects robots.txt

(You can also use the internal path /bots/concepts/bot/verified-bots/ instead of the full developers.cloudflare.com URL.)

3. Stale description in bot-verification index

File: src/content/docs/bots/reference/bot-verification/index.mdx (line 4)

The description still references the deprecated "signed agents" term, while the body text below was already updated.

-description: Validation methods Cloudflare uses to verify bots and signed agents.
+description: Validation methods Cloudflare uses to verify bots and agents.

Minor notes & nits

  • Redirect granularity: The wildcard redirect /bots/concepts/bot/signed-agents/* → /bots/concepts/bot/verified-bots/ will drop any subpath (including /policy/). This is acceptable for a deprecated concept, but if you want to preserve intent you could add a targeted redirect for /bots/concepts/bot/signed-agents/policy/ to /bots/concepts/bot/verified-bots/ (or a relevant anchor).
  • bots/index.mdx overview page: Consider adding a <Feature> card on the Bots overview page for the new Attribution Business Insights page so it is discoverable from the product landing page. This is optional.
  • Changelog link style: The changelog entry uses a full https://developers.cloudflare.com/... URL for the signed-agents link. For consistency with the rest of the docs, prefer the root-relative path /bots/concepts/bot/verified-bots/ when updating.

What looks good ✅

  • New attribution-business-insights.mdx has valid frontmatter, correct pcx_content_type: concept, and proper sidebar.order: 6.
  • account-abuse-protection.mdx correctly bumped to order: 7.
  • dash-routes/core.json deep-link registration is present and correctly formatted.
  • Glossary additions (direct, intermediary, signed agent) are properly structured.
  • Verified-bots partial and all repointed inbound links (variables, fields, Web Bot Auth, bot verification) are updated correctly.
  • The behavior-based AI presets table in verified-bots/index.mdx and the updated block-ai-bots.mdx steps are clear and correctly use Starlight components.
  • MDX syntax (note blocks, tables, bold, links) is valid throughout the changed files.

github run

- Add BotBase page (sidebar between Bot Analytics and Attribution Business Insights);
  bump Attribution (6->7) and Account Abuse Protection (7->8) order
- Rename the User behavior/preset to Agent across AI bots, verified bots, and Block AI Bots
- Fix redirects: drop unslashed signed-agents source; move wildcard to the dynamic
  redirect section (resolves validate-redirects failures)
- Repoint stale signed-agents changelog link to verified bots
- Update bot-verification index description (signed agents -> agents)
@jinhee-c-lee jinhee-c-lee requested a review from a team as a code owner June 30, 2026 04:15
- New defaults are enforced on September 15, 2026 (not July 1); AI traffic
  management OPTIONS are available now
- Replace the 'two Training options' framing with the blog's model: blocking
  Training also blocks multi-purpose crawlers (Googlebot/Applebot/Bingbot) that
  combine Search + Training, via the new options or the legacy Block AI bots
  service; customers can opt out of the new defaults before Sept 15
- Order classifications as Search, Agent, Training across AI bots, Block AI Bots,
  BotBase, and verified bots
- Clarify Verified now makes a bot allowable through its behavior category, with
  baselines taking effect Sept 15
@github-actions

github-actions Bot commented Jun 30, 2026

Copy link
Copy Markdown
Contributor

Preview URL: https://97c9fc35.preview.developers.cloudflare.com
Preview Branch URL: https://cid-2026-bots-taxonomy.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link Updated Link
https://developers.cloudflare.com/bots/concepts/bot/signed-agents/policy/ https://cid-2026-bots-taxonomy.preview.developers.cloudflare.com/bots/concepts/bot/signed-agents/policy/
https://developers.cloudflare.com/bots/botbase/ https://cid-2026-bots-taxonomy.preview.developers.cloudflare.com/bots/botbase/
https://developers.cloudflare.com/bots/concepts/bot/ https://cid-2026-bots-taxonomy.preview.developers.cloudflare.com/bots/concepts/bot/
https://developers.cloudflare.com/bots/concepts/bot/verified-bots/ https://cid-2026-bots-taxonomy.preview.developers.cloudflare.com/bots/concepts/bot/verified-bots/
https://developers.cloudflare.com/bots/attribution-business-insights/ https://cid-2026-bots-taxonomy.preview.developers.cloudflare.com/bots/attribution-business-insights/
https://developers.cloudflare.com/bots/concepts/bot/signed-agents/ https://cid-2026-bots-taxonomy.preview.developers.cloudflare.com/bots/concepts/bot/signed-agents/
https://developers.cloudflare.com/bots/additional-configurations/block-ai-bots/ https://cid-2026-bots-taxonomy.preview.developers.cloudflare.com/bots/additional-configurations/block-ai-bots/
https://developers.cloudflare.com/bots/reference/bot-verification/ https://cid-2026-bots-taxonomy.preview.developers.cloudflare.com/bots/reference/bot-verification/
https://developers.cloudflare.com/changelog/post/2026-03-10-br-crawl-endpoint/ https://cid-2026-bots-taxonomy.preview.developers.cloudflare.com/changelog/post/2026-03-10-br-crawl-endpoint/
https://developers.cloudflare.com/bots/account-abuse-protection/ https://cid-2026-bots-taxonomy.preview.developers.cloudflare.com/bots/account-abuse-protection/
https://developers.cloudflare.com/bots/reference/bot-management-variables/ https://cid-2026-bots-taxonomy.preview.developers.cloudflare.com/bots/reference/bot-management-variables/
https://developers.cloudflare.com/bots/reference/bot-verification/web-bot-auth/ https://cid-2026-bots-taxonomy.preview.developers.cloudflare.com/bots/reference/bot-verification/web-bot-auth/

…l-endpoint/

Resolves the Post Build link-validation failure (/browser-rendering/ is not a
valid page in this repo).
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

product:bots Related to Bots product size/m

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants