
OAI-SearchBot: Technical Guide for ChatGPT Search Visibility
A technical guide to OAI-SearchBot, including robots.txt controls, crawl verification and the distinction between ChatGPT search and model training.
OAI-SearchBot is OpenAI's crawler for search-related discovery and surfacing. If you want eligible public pages to appear in summaries and snippets in ChatGPT search, OpenAI says you should not block it. OAI-SearchBot is distinct from GPTBot, which controls potential training use, and ChatGPT-User, which supports user-initiated activity.
This distinction lets publishers make a search-visibility decision without automatically making the same decision about model training.
The Three OpenAI Agents to Distinguish
| Agent | Documented purpose | Primary control question |
|---|---|---|
| OAI-SearchBot | Search discovery and surfacing | Should public content be eligible for ChatGPT search summaries and links? |
| GPTBot | Potential model training | May OpenAI crawl this content for possible model improvement? |
| ChatGPT-User | User-initiated actions | May ChatGPT access the page when a user requests an interaction? |
Do not create rules from the label alone. Check OpenAI's live publisher documentation and crawler identification page before deployment.
Recommended Robots Configuration
To allow ChatGPT search discovery while opting out of GPTBot crawling:
```
User-agent: OAI-SearchBot
Allow: /
User-agent: GPTBot
Disallow: /
```
Add path restrictions required by your content policy. Keep private pages behind real access controls; robots rules are not authentication.
The complete AI-crawler robots.txt guide covers wildcard groups, partial access and safe testing.
What OAI-SearchBot Access Does—and Does Not—Mean
Allowing OAI-SearchBot means the crawler is permitted to fetch matching pages. It does not mean:
- Every page will be crawled immediately.
- The page will be indexed or cited.
- A specific prompt will trigger web search.
- Your brand will be recommended.
- A citation will remain stable across repeated answers.
- OpenAI endorses the page or organization.
Think of access as the first gate in a longer process involving discovery, retrieval, answer construction and attribution.
Verify Production Access
Audit at least five layers:
- DNS and TLS: the host resolves and negotiates a valid connection.
- Robots: the production file permits the intended paths.
- Edge security: CDN and WAF rules do not block or challenge verified requests.
- Application response: priority pages return the intended status and content.
- Page directives: canonical and indexing signals match the policy.
Compare normal requests with verified crawler requests. Save the response status, headers, body size and a content sample. A 200 response containing a bot challenge is not useful access.
Use the AI crawler audit framework when diagnosing an entire site.
Verify OpenAI Crawler Identity
User-agent strings are plain text and can be copied by other clients. Use OpenAI's current crawler identification guidance and published IP information where available. Verify both network origin and agent string before relaxing security controls.
Operationally:
- Retrieve official ranges securely.
- Track changes.
- Apply least-privilege WAF rules.
- Log successful and failed requests.
- Alert on unexpected volume or sensitive paths.
- Retain a rollback mechanism.
Do not hard-code ranges from an old blog post.
Indexing and Noindex
OpenAI states that if a disallowed page is discovered from another source, some experiences may still surface its title and link. If you do not want a page shown, use noindex; the crawler must be allowed to access the page to read that directive.
This creates an important configuration rule:
- Use robots controls to manage crawling.
- Use
noindexto request exclusion from eligible search results. - Use authentication to protect non-public information.
Do not rely on one control to perform all three jobs.
Make the Retrieved Page Useful
After access is correct, improve source quality:
- State the page's question and answer clearly.
- Put supporting evidence near material claims.
- Use stable canonical URLs.
- Name authors and reviewers.
- Date material updates.
- Provide original examples, data or documentation.
- Explain limitations.
- Connect related pages with descriptive internal links.
The citation-ready content guide provides a page-level editorial process.
Track ChatGPT Referral Traffic
OpenAI says referral links from ChatGPT include utm_source=chatgpt.com, enabling publishers to identify inbound sessions in analytics. Create a channel grouping that recognizes the parameter and the referring domain, while preserving raw source data.
Report referral traffic separately from:
- Brand mentions in an answer.
- Visible citations.
- SearchBot crawl events.
- Conversions influenced through another channel.
A citation can produce no click, and a referral session does not reveal every answer that influenced the visit.
Troubleshooting Matrix
| Symptom | Likely checks |
|---|---|
| No OAI-SearchBot logs | Discovery, internal links, sitemap, robots and whether the bot has attempted the site |
| 403 or challenge | CDN bot rules, WAF event, IP verification and rate limits |
| Crawled URL not cited | Intent match, passage quality, competing sources and prompt variability |
| Old URL cited | Redirects, canonicals, stale duplicates and external links |
| Referral traffic not classified | UTM parsing, channel rules, redirects and consent configuration |
A Safe Deployment Checklist
- Policy owner confirms search and training decisions.
- Production robots file uses current documented agent tokens.
- WAF rules validate identity rather than trusting the header.
- Priority templates return usable HTML.
- Canonical and
noindexsignals are intentional. - Analytics recognizes ChatGPT referrals.
- Crawl and citation observations are monitored separately.
- Rules are reviewed when OpenAI updates its documentation.
Frequently Asked Questions
Is OAI-SearchBot the Same as GPTBot?
No. OpenAI documents OAI-SearchBot for search visibility and GPTBot for potential model training. They can be controlled separately.
Can I Force OAI-SearchBot to Crawl a URL?
OpenAI does not document a guaranteed submission mechanism comparable to a promise of immediate crawling. Make pages discoverable, accessible and linked, then monitor logs.
Does Blocking GPTBot Remove a Site from ChatGPT Search?
Not by itself. Search discovery is controlled separately through OAI-SearchBot according to OpenAI's publisher guidance.




