Caution Official docs AI & LLM Bots

Ceramic AI TerraCotta

Operated by Ceramic AI

Quick Facts

User-Agent:
TerraCotta
Category:
AI & LLM Bots
Operator:
Ceramic AI
Safety:
Use Caution
Blocking Impact:
Low - No SEO ranking impact
SEO Impact Score:
2/10
Official docs:
ceramic.ai

Confirmed by the operator

Ceramic AI names TerraCotta on its own documentation page, linked above. The token, purpose and robots.txt behaviour on this profile come from that page, re-checked on October 19, 2026.

What is Ceramic AI TerraCotta?

Ceramic AI TerraCotta is an AI data-collection crawler operated by Ceramic AI. It gathers public web content to build or refine training datasets for large language models. Like other AI training crawlers, Ceramic AI TerraCotta does not influence your search-engine rankings, so you can block it via robots.txt without any SEO penalty if you wish to opt out of AI training.

Ceramic AI TerraCotta is an AI data-collection crawler operated by Ceramic AI. It gathers public web content to build or refine training datasets for large language models. Like other AI training crawlers, Ceramic AI TerraCotta does not influence your search-engine rankings, so you can block it via robots.txt without any SEO penalty if you wish to opt out of AI training.
Ceramic AI TerraCotta uses the user-agent token TerraCotta. You can control it via robots.txt, meta tags (noai), or the emerging llms.txt standard. Robots.txt is voluntary; for hard enforcement, combine it with server-level IP blocking.

What happens if you block Ceramic AI TerraCotta?

✅ No SEO Impact - Blocking Ceramic AI TerraCotta does not affect your rankings in Google, Bing, or any other search engine. Ceramic AI TerraCotta is an AI crawler, not a traditional search indexer. You can freely block it via User-agent / Disallow: / without any SEO penalty.
Generally safe to allow; provides legitimate crawling value.

Want to see whether Ceramic AI TerraCotta actually visits you? Read how do I monitor AI bot traffic to my website?

How to block Ceramic AI TerraCotta with robots.txt

<code>User-agent: TerraCotta</code> - Matching is case-insensitive. Robots.txt is fetched from the root of each subdomain separately.

Block completely (robots.txt)
User-agent: TerraCotta Disallow: /
Allow all (robots.txt)
User-agent: TerraCotta Allow: /
Block private only (robots.txt)
User-agent: TerraCotta Disallow: /private/ Disallow: /api/ Disallow: /admin/ Allow: /
Nginx server block
# Nginx: Hard-block Ceramic AI TerraCotta if ($http_user_agent ~* "TerraCotta") { return 403 "Bot blocked"; }
Apache .htaccess
# Apache: Hard-block Ceramic AI TerraCotta SetEnvIfNoCase User-Agent "TerraCotta" bad_bot Order Allow,Deny Allow from all Deny from env=bad_bot
Meta robots tag
<meta name="robots" content="noindex, nofollow">
X-Robots-Tag header
X-Robots-Tag: noindex, nofollow

Is Ceramic AI TerraCotta safe to allow?

Ceramic AI TerraCotta is generally legitimate but warrants caution. It is operated by Ceramic AI. Review its crawl behaviour in your logs and apply robots.txt or rate-limiting if its activity is heavier than you expect.
Verify by reverse-DNS lookup: legitimate Ceramic AI TerraCotta requests resolve to Ceramic AI's domain.

What does Ceramic AI TerraCotta do?

Understanding Ceramic AI TerraCotta's purpose helps you decide whether to allow or block it.

  • Collects public web content to train large language models
  • Builds and refreshes AI training datasets
  • Harvests text, code, and structured data for model improvement
  • Does NOT affect search-engine rankings
  • Can be blocked to opt out of AI training without SEO loss

Ceramic AI TerraCotta in context

Ceramic AI TerraCotta is a training crawler operated by Ceramic AI. In plain terms, it collects pages to train AI models. Our database files it under AI and LLM crawlers and ranks it Tier 2, important crawlers from established AI and search operators. 74 of the 104 AI and LLM crawlers in our database share this tier.

Its safety rating is caution and its blocking impact is low. So the decision about Ceramic AI TerraCotta rests on what you want from Ceramic AI, not on its behaviour. How we rate safety and impact.

How site owners treat Ceramic AI TerraCotta

Our robots.txt study of the Tranco top 10,000 did not track TerraCotta as a named token, so we do not publish an adoption figure for it. If you run a large site, your own logs are the best evidence of how often it visits.

Does it follow robots.txt?

Ceramic AI TerraCotta's operator does not clearly document how it treats robots.txt. Write the Ceramic AI TerraCotta rule anyway, then confirm in your logs that its requests stop.

Ceramic AI crawlers and close alternatives

Ceramic AI runs only this one crawler in our database, so a single User-agent: TerraCotta group controls everything Ceramic AI fetches through it.

Other AI and LLM crawlers that do the same job (collects pages to train AI models) include ClaudeBot from Anthropic, Google-Extended from Google, GPTBot from OpenAI, Meta-ExternalAgent from Meta, AI2Bot from Allen Institute for AI, aiHitBot from aiHit. Deciding about Ceramic AI TerraCotta is usually a decision about the whole group, so check how your file treats these too.

We first recorded TerraCotta on September 22, 2026. Ceramic AI documents it on ceramic.ai, and we recheck that page before each release.

Which rule Ceramic AI TerraCotta actually follows

Ceramic AI TerraCotta reads exactly one group in robots.txt, the most specific one that names TerraCotta, and never combines rules across groups. This short file shows the trap:

User-agent: *
Disallow: /private/

User-agent: TerraCotta
Disallow: /drafts/
  1. Find the group. Ceramic AI TerraCotta looks for a group naming TerraCotta. One exists, so it ignores User-agent: * completely.
  2. Apply only that group. It is refused /drafts/ and nothing else.
  3. The surprise. /private/ is open to Ceramic AI TerraCotta, because that rule lives in the * group it no longer reads. To keep it out of both, repeat Disallow: /private/ inside its own group.
Test yourself: does a rule under User-agent: * apply to Ceramic AI TerraCotta if the file also has a User-agent: TerraCotta group?

No. Once a group names it, Ceramic AI TerraCotta reads only that group. Put every rule you want it to follow inside its own group.

Test yourself: will blocking Ceramic AI TerraCotta remove your pages from AI answers?

No. Ceramic AI TerraCotta collects training data. Blocking it changes what future models learn, not which pages AI answers cite today.

Test yourself: is User-agent: terracotta the same as User-agent: TerraCotta?

Yes. RFC 9309 makes user-agent matching case-insensitive. Paths are a different story: Disallow: /Blog/ does not block /blog/.

Should you allow Ceramic AI TerraCotta? Decide by situation

Recommended setting for Ceramic AI TerraCotta by type of site
If you are...Recommended setting
You publish content and want AI answers to cite itYour call. Ceramic AI TerraCotta is a training crawler, so blocking it does not remove you from AI answers; retrieval crawlers do that job.
You license content and want to stop AI trainingBlock it by name with User-agent: TerraCotta and Disallow: /.
You run an online shopAllow it unless your logs show it is costly.
Your server is under load from botsRate-limit before blocking. It is rated caution in our database.

Check Ceramic AI TerraCotta on your own site

  1. Open /robots.txt on your domain and search for TerraCotta. If it is not named, it follows User-agent: *.
  2. List the Disallow lines in the group Ceramic AI TerraCotta follows and test your key URLs against them; the longest match wins, and Allow wins a tie.
  3. Look beyond the file. A firewall or bot manager can refuse Ceramic AI TerraCotta even when robots.txt allows it, and that never shows in the file.
  4. Run our crawlability checker for AI search to see how Ceramic AI TerraCotta and every other crawler we track are treated in one pass, including firewall refusals.

Common mistakes with Ceramic AI TerraCotta

The errors we see most often with Ceramic AI TerraCotta in the files and firewalls we test:

  1. Assuming that blocking Ceramic AI TerraCotta removes you from AI answers. It is a training crawler; AI answers are fed by retrieval and user-triggered crawlers with different tokens.
  2. Blocking Ceramic AI TerraCotta with a broad User-agent: * rule that also catches search engines. Name TerraCotta in its own group instead.
  3. Expecting a Ceramic AI TerraCotta block to remove content already collected. robots.txt only affects future visits.

All three hide inside a file that looks correct, so check Ceramic AI TerraCotta from outside after every change.

Spotting Ceramic AI TerraCotta in your logs

robots.txt says what Ceramic AI TerraCotta may do; your access logs show what it actually did.

Count requests

On a server with standard Nginx or Apache logs, this counts matching requests per day (adjust the log path for your host):

grep -iE "TerraCotta" /var/log/nginx/access.log \
  | awk '{print $4}' | cut -d: -f1 | sort | uniq -c

And this shows which paths it requested most, which is the quickest way to see whether your Disallow lines are being respected:

grep -iE "TerraCotta" /var/log/nginx/access.log \
  | awk '{print $7}' | sort | uniq -c | sort -rn | head -20

Check the requests are genuine

Anyone can send the Ceramic AI TerraCotta user-agent, so confirm the source before acting on a match:

  • TerraCotta: we hold no published IP list, so use reverse DNS where the operator documents a hostname and treat an unverifiable Ceramic AI TerraCotta request with caution.

Frequently Asked Questions

What is the official user-agent string for Ceramic AI TerraCotta?
The official user-agent string for Ceramic AI TerraCotta is: TerraCotta. Use this exact string in robots.txt, Nginx, Apache, or Cloudflare firewall rules to target this bot. Matching in robots.txt is case-insensitive. Verify a request genuinely comes from Ceramic AI TerraCotta by performing a reverse-DNS lookup on the source IP.
Is Ceramic AI TerraCotta safe?
Ceramic AI TerraCotta is generally legitimate but warrants caution. It is operated by Ceramic AI. Review its crawl behaviour in your logs and apply robots.txt or rate-limiting if its activity is heavier than you expect.
Will blocking Ceramic AI TerraCotta hurt my SEO?
✅ No SEO Impact - Blocking Ceramic AI TerraCotta does not affect your rankings in Google, Bing, or any other search engine. Ceramic AI TerraCotta is an AI crawler, not a traditional search indexer. You can freely block it via User-agent / Disallow: / without any SEO penalty.
How do I block Ceramic AI TerraCotta in robots.txt?
Add the following lines to your /robots.txt file:
User-agent: TerraCotta
Disallow: /

This instructs Ceramic AI TerraCotta not to crawl any path on your site. To block only specific sections, replace / with the path (e.g., Disallow: /blog/).
Does Ceramic AI TerraCotta respect robots.txt?
Ceramic AI TerraCotta is operated by Ceramic AI and is expected to fetch and parse /robots.txt before crawling, following RFC 9309. For hard enforcement, combine robots.txt with server-level IP or user-agent blocking.
How do I verify if Ceramic AI TerraCotta is crawling my site?
Search your web server access logs for the string TerraCotta (case-insensitive: grep -i "TerraCotta" /var/log/nginx/access.log). Filter by user-agent in your log analytics tool (GoAccess, AWStats, etc.).

Related Bots

WhatsApp us