Issue Station
Sign In
Tools hereToolbox

codex - 💡(How to fix) Fix Support blocked_domains in tools.web_search config

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

Root Cause

In some cases, users want Codex to keep using broad web search, but exclude one or more domains from search results. Using allowed_domains is not a good substitute because it turns the configuration into a strict allowlist and requires enumerating every acceptable domain.

Code Example

web_search = "live"

[tools.web_search]
allowed_domains = ["docs.example"]

---

web_search = "live"

[tools.web_search]
blocked_domains = ["some-domain.example"]
RAW_BUFFERClick to expand / collapse

What variant of Codex are you using?

CLI

What feature would you like to see?

Please add support for configuring blocked domains for the hosted web_search tool.

The Responses API web search tool supports a filters.blocked_domains option, but Codex currently appears to expose only allowed_domains through tools.web_search config.

Today, users can configure:

web_search = "live"

[tools.web_search]
allowed_domains = ["docs.example"]

However, there does not seem to be a way to express the inverse policy:

web_search = "live"

[tools.web_search]
blocked_domains = ["some-domain.example"]

Why is this useful?

In some cases, users want Codex to keep using broad web search, but exclude one or more domains from search results. Using allowed_domains is not a good substitute because it turns the configuration into a strict allowlist and requires enumerating every acceptable domain.

Additional information

No response

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

codex - 💡(How to fix) Fix Support blocked_domains in tools.web_search config