htmlLimitedBots
Last updated October 3, 2025
ThehtmlLimitedBots config allows you to specify a list of user agents that should receive blocking metadata instead ofstreaming metadata.
next.config.ts
importtype { NextConfig }from'next'constconfig:NextConfig= { htmlLimitedBots: /MySpecialBot|MyAnotherSpecialBot|SimpleCrawler/,}exportdefault configDefault list
Next.js includes a default list of HTML limited bots, including:
- Google crawlers (e.g. Mediapartners-Google, AdsBot-Google, Google-PageRenderer)
- Bingbot
- Twitterbot
- Slackbot
See the full listhere.
Specifying ahtmlLimitedBots config will override the Next.js' default list. However, this is advanced behavior, and the default should be sufficient for most cases.
next.config.ts
constconfig:NextConfig= { htmlLimitedBots: /MySpecialBot|MyAnotherSpecialBot|SimpleCrawler/,}exportdefault configDisabling
To fully disable streaming metadata:
next.config.ts
importtype { NextConfig }from'next'constconfig:NextConfig= { htmlLimitedBots: /.*/,}exportdefault configVersion History
| Version | Changes |
|---|---|
| 15.2.0 | htmlLimitedBots option introduced. |
Was this helpful?