---
title: "v4.0.0 · Nuxt Robots · Nuxt SEO"
canonical_url: "https://nuxtseo.com/docs/robots/releases/v4"
last_updated: "2026-08-16T10:05:26.528Z"
meta:
description: "Release notes for Nuxt Robots v4.0.0."
"og:description": "Release notes for Nuxt Robots v4.0.0."
"og:title": "v4.0.0 · Nuxt Robots · Nuxt SEO"
---
Nuxt SEO on GitHub
Switch to RobotsSwitch to Nuxt SEOSwitch to SitemapSwitch to OG ImageSwitch to Schema.orgSwitch to Link CheckerSwitch to SEO UtilsSwitch to Site ConfigSwitch to Skew ProtectionSwitch to AI Ready
**Releases**
# **v4.0.0**
## Nuxt Simple Robots is now Nuxt Robots
In a [**~~discussion~~**](https://github.com/nuxt-modules/robots/issues/116) with the team and the community, we have decided to migrate `**nuxt-simple-robots**` into the `**@nuxtjs/robots**` module.
This will allow me to better maintain the module and provide a more consistent experience across the Nuxt ecosystem.
To upgrade simply replace the dependency in `**package.json**` and update your nuxt.config.
```diff
- 'nuxt-simple-robots'
+ '@nuxtjs/robots'
```
If you're coming from `**nuxt-simple-robots**` then no other changes are needed. If you're coming from `**@nuxtjs/robots**` v3, then the following breaking changes exist.
**`**@nuxtjs/robots**` v3 breaking changes:**
- The `**configPath**` config is no longer supported. For custom runtime config you should use [**~~Nitro Hooks~~**](https://nuxtseo.com/docs/robots/nitro-api/nitro-hooks).
- The `**rules**` config is deprecated but will continue to work. Any `**BlankLine**` or `**Comment**` rules will no longer work.
- Using `**CleanParam**`, `**CrawlDelay**` and `**Disavow**` requires targeting the [**~~Yandex~~**](https://nuxtseo.com/docs/robots/advanced/yandex) user agent.
## Features
### useRobotsRule()
A new Nuxt composable [**~~useRobotsRule()~~**](https://nuxtseo.com/docs/robots/api/use-robots-rule) has been introduced to allow you to access and modify the current robots rule for the current route.
```ts
import { useRobotsRule } from '#imports'
const rule = useRobotsRule()
// Ref<'noindex, nofollow'>
```
### Robots.txt validation
When loading in a `**robots.txt**` file, the module will now validate the file to ensure each of the `**disallow**` and `**allow**` paths are valid.
This will help you avoid errors from Google Search Console and Google Lighthouse. You can also run this [**~~robots.txt validation~~**](https://nuxtseo.com/tools/robots-txt-validator) against any live URL without installing the module.
### Default Meta Tag
The module now adds the meta tag to your site by default. The composable and component helpers used to define this previously have been deprecated.
```html
```
Adding the meta tag is important for pages that are prerendered as the `**X-Robots-Tag**` header is not available.
You can opt out with `**metaTag: false**`.
### I18n Integration
The module now integrates with [**~~nuxt-i18n~~**](https://i18n.nuxtjs.org/).
This will automatically re-configure your `**allow**` and `**disallow**` rules to include the locale prefix if you have omitted it.
nuxt.config.ts
```ts
export default defineNuxtConfig({
robots: {
allow: ['/about'],
disallow: ['/admin'],
},
i18n: {
strategy: 'prefix_except_default',
locales: ['en', 'fr'],
defaultLocale: 'en',
},
})
```
```txt
# robots.txt
User-agent: *
Allow: /about
Allow: /fr/about
Disallow: /admin
Disallow: /fr/admin
```
Learn more on the [**~~I18n Integration~~**](https://nuxtseo.com/docs/robots/advanced/i18n) docs.
### Nuxt Content Integration
The module now integrates with [**~~@nuxt/content~~**](https://content.nuxt.com/). Allowing you to use the `**robots**` frontmatter key within your markdown files.
```md
---
robots: false
---
```
Learn more on the [**~~Nuxt Content~~**](https://nuxtseo.com/docs/robots/advanced/content) docs.
### Nuxt DevTools Integration
The module now integrates with [**~~Nuxt DevTools~~**](https://devtools.nuxt.com/).
You can visit the Robots tab and see if the current route is indexable, and if not, why.
### New Nitro Hook and Util Exports
In this version the new Nitro hook `**robots:config**` was introduced. This hook will let you override the robots.txt data as a JavaScript object, instead of a string.
Likewise you can now re-use any of the internal functions to parse, validate and generate robots.txt data using the `**@nuxtjs/robots/util**` export.
```ts
import { parseRobotsTxt } from '@nuxtjs/robots/util'
export default defineNitroPlugin((nitroApp) => {
nitroApp.hooks.hook('robots:config', async (ctx) => {
if (ctx.context === 'robots.txt') {
const customRobotsTxt = await $fetch('https://example.com/robots.txt')
const parsed = parseRobotsTxt(config)
config.groups = defu(config.groups, parsed.groups)
}
})
})
```
## Breaking Changes
**Site config.** The deprecated Nuxt Config site config keys have been removed: `**host**`, `**siteUrl**`, `**indexable**`.
You will need to configure these using [**~~Site Config~~**](https://nuxtseo.com/docs/site-config/getting-started/introduction).
```diff
export default defineNuxtConfig({
robots: {
- indexable: false,
},
site: {
+ indexable: false,
}
})
```
## Deprecations
### `**defineRobotMeta()**` and `****`
Because the module now uses a default meta tag, the `**defineRobotMeta()**` function and `****` component are deprecated.
You should remove this from your code.
### `**index**` Route Rule
The `**index**` route rule has been deprecated in favor of the `**robots**` rule. This provides less ambiguity and more control over the rule.
```diff
export default defineNuxtConfig({
routeRules: {
'/admin': {
- index: false,
+ robots: false,
}
}
})
```
**Was this page helpful?**
[**v5.0.0** Release notes for Nuxt Robots v5.0.0.](https://nuxtseo.com/docs/robots/releases/v5) [**v3.0.0** Release notes for Nuxt Robots v3.0.0.](https://nuxtseo.com/docs/robots/releases/v3)