Skip to main content

Adding Content-Signal to a docs site

Published:

2 min read

347 words

A few weeks ago I ran isagentready.com on docs.expo.dev, a site that I manage and work on, for my day job. One of the failed references during the check was the lack of Content-Signal policy in robots.txt file of the site.

Just for context, isagentsready.com is a tool that checks if a site is ready for AI agents to crawl and index, and is developed by Cloudflare.

What is Content-Signal?

Cloudflare announced the Content Signals Policy in September 2025 as an extension to robots.txt. It is one policy with three flags, each set to yes or no. In a nutshell, if you add it, this is what it looks like in your robots.txt file:

User-Agent: *
Content-Signal: search=yes, ai-train=no, ai-input=yes
Allow: /

The flags to pay attention in the above snippet are the following signals:

One thing to note here is that Cloudflare do mention that omitting a signal neither grants nor restricts permission. So, it is more of a nice to have, cover the grounds so your documentation site isn’t left behind.

Note: The reference site, contentsignals.org, describes the vocabulary as coming from a proposed IETF standard drafted by the AI Preferences (aipref) working group.

Why is this an auto-yes for a docs site

The content policy’s obvious audience is on of those publisher who wants to refuse. Documentation run on different economics and for many of us, docs is the product.

Adding this policy to your robots.txt file doesn’t replace the work you need to do to get answers picked from your docs site for AI Answer search engine optimization. You still need to apply other methods or audit your docs site using afdocs.dev to ensure your docs site is ready for AI agents. There are also other methods like exposing JSON-LD structured data and adding llms.txt, which I have written before in docs discoverability layers, and about adding llms.txt to this blog.


Next Post
My impressions after using Claude Code for six months

Aman Mittal author

I'm a software developer and technical writer. On this blog, I share my learnings about both fields. Recently, I have begun exploring other topics, so don't be surprised if you find something new here.

Currently, working on documentation at Expo.

Tech writing blog webring | Static.Quest webring