v3.0.0 · Nuxt Robots · Nuxt SEO

[NuxtSEO](https://nuxtseo.com/ "Home")

- [Modules](https://nuxtseo.com/docs/nuxt-seo/getting-started/introduction)
- [Tools](https://nuxtseo.com/tools)
- [Pro](https://nuxtseo.com/pro)
- [Learn SEO](https://nuxtseo.com/learn-seo/nuxt) [Releases](https://nuxtseo.com/releases)

[1.4K](https://github.com/harlan-zw/nuxt-seo)

[Nuxt SEO on GitHub](https://github.com/harlan-zw/nuxt-seo)

[User Guides](https://nuxtseo.com/docs/robots/getting-started/introduction)

[API](https://nuxtseo.com/docs/robots/api/use-robots-rule)

[Releases](https://nuxtseo.com/docs/robots/releases/v6)

Robots

- [Switch to Robots](https://nuxtseo.com/docs/robots/getting-started/introduction)
- [Switch to Nuxt SEO](https://nuxtseo.com/docs/nuxt-seo/getting-started/introduction)
- [Switch to Sitemap](https://nuxtseo.com/docs/sitemap/getting-started/introduction)
- [Switch to OG Image](https://nuxtseo.com/docs/og-image/getting-started/introduction)
- [Switch to Schema.org](https://nuxtseo.com/docs/schema-org/getting-started/introduction)
- [Switch to Link Checker](https://nuxtseo.com/docs/link-checker/getting-started/introduction)
- [Switch to SEO Utils](https://nuxtseo.com/docs/seo-utils/getting-started/introduction)
- [Switch to Site Config](https://nuxtseo.com/docs/site-config/getting-started/introduction)
- [Switch to Skew Protection](https://nuxtseo.com/docs/skew-protection/getting-started/introduction)
- [Switch to AI Ready](https://nuxtseo.com/docs/ai-ready/getting-started/introduction)

Search…```k`` /`

v6.0.6

- Playgrounds
- [Discord Support](https://discord.com/invite/275MBUBvgP)

### Changelog

### Releases

- [v6.0.0](https://nuxtseo.com/docs/robots/releases/v6)
- [v5.0.0](https://nuxtseo.com/docs/robots/releases/v5)
- [v4.0.0](https://nuxtseo.com/docs/robots/releases/v4)
- [v3.0.0](https://nuxtseo.com/docs/robots/releases/v3)

Releases

# v3.0.0

[Copy for LLMs](https://nuxtseo.com/docs/robots/releases/v3.md)

## [Features 🚀](#features)

### [Robots.txt Config](#robotstxt-config)

The [robots.txt standard](https://developers.google.com/search/docs/crawling-indexing/robots/create-robots-txt) is important for search engines to understand which pages to crawl and index.

To match closer to the standard, Nuxt Robots now allows you to configure the module by using a `robots.txt` file.

Example File Structure

```
public/_robots.txt
```

This file will be parsed and used to configure the module.

If you need programmatic control, you can still configure the module using [nuxt.config.ts](https://nuxtseo.com/docs/robots/guides/nuxt-config), [Route Rules](https://nuxtseo.com/docs/robots/guides/route-rules) and [Nitro hooks](https://nuxtseo.com/docs/robots/nitro-api/nitro-hooks).

Read more at [Robots.txt Config](https://nuxtseo.com/docs/robots/guides/robots-txt).

### [New Config: `groups`](#new-config-groups)

- Type: `{ userAgent: []; allow: []; disallow: []; comment: []}[]`
- Default: `[]`

Define more granular rules for the robots.txt. Each group is a set of rules for specific user agent(s).

```
export default defineNuxtConfig({
  robots: {
    groups: [
      {
        userAgent: ['AdsBot-Google-Mobile', 'AdsBot-Google-Mobile-Apps'],
        disallow: ['/admin'],
        allow: ['/admin/login'],
        comment: 'Allow Google AdsBot to index the login page but no-admin pages'
      },
    ]
  }
})
```

### [New Config: `blockNonSeoBots`](#new-config-blocknonseobots)

- Type: `boolean`
- Default: `false`

Blocks some non-SEO bots from crawling your site. This is not a replacement for a full-blown bot management solution, but it can help to reduce the load on your server.

See [const.ts](https://github.com/nuxt-modules/robots/blob/main/src/const.ts#L6) for the list of bots that are blocked.

```
export default defineNuxtConfig({
  robots: {
    blockNonSeoBots: true
  }
})
```

### [Improved header / meta tag integration](#improved-header-meta-tag-integration)

Previously, only routes added to the `routeRules` would be used to display the `X-Robots-Tag` header and the `<meta name="robots" content="..." />` tag.

This has been changed to include all `disallow` paths for the `*` user-agent by default.

### [New Config: `credits`](#new-config-credits)

- Type: `boolean`
- Default: `true`

Control the module credit comment in the generated robots.txt file.

```
# START nuxt-robots (indexable) <- credits
 ...
# END nuxt-robots <- credits
```

```
export default defineNuxtConfig({
  robots: {
    credits: false
  }
})
```

### [New Config: `debug`](#new-config-debug)

- Type: `boolean`
- Default: `false`

Enables debug logs.

```
export default defineNuxtConfig({
  robots: {
    debug: true
  }
})
```

## [Deprecations](#deprecations)

### [Nuxt Site Config Integration](#nuxt-site-config-integration)

The module now integrates with the [nuxt-site-config](https://github.com/harlan-zw/nuxt-site-config) module.

The `siteUrl` and `indexable` config is now deprecated, but will still work.

For most sites, you won't need to provide any further configuration, everything will just work. If you need to modify the default config, the easiest way is to do so through the `site` config.

```
export default defineNuxtConfig({
  site: {
    url: 'https://example.com',
    indexable: true
  }
})
```

[Edit this page](https://github.com/nuxt-modules/robots/edit/main/docs/content/4.releases/6.v3.md)

[Markdown For LLMs](https://nuxtseo.com/docs/robots/releases/v3.md)

Did this page help you?

[v4.0.0 Release notes for Nuxt Robots v4.0.0.](https://nuxtseo.com/docs/robots/releases/v4) 

On this page

- [Features 🚀](#features)
- [Deprecations](#deprecations)

[GitHub](https://github.com/harlan-zw/nuxt-seo) [ Discord](https://discord.com/invite/275MBUBvgP)

### [NuxtSEO](https://nuxtseo.com/ "Home")

- [Getting Started](https://nuxtseo.com/docs/nuxt-seo/getting-started/introduction)
- [MCP](https://nuxtseo.com/docs/nuxt-seo/guides/mcp)

Modules

- [Robots](https://nuxtseo.com/docs/robots/getting-started/introduction)
- [Sitemap](https://nuxtseo.com/docs/sitemap/getting-started/introduction)
- [OG Image](https://nuxtseo.com/docs/og-image/getting-started/introduction)
- [Schema.org](https://nuxtseo.com/docs/schema-org/getting-started/introduction)
- [Link Checker](https://nuxtseo.com/docs/link-checker/getting-started/introduction)
- [SEO Utils](https://nuxtseo.com/docs/seo-utils/getting-started/introduction)
- [Site Config](https://nuxtseo.com/docs/site-config/getting-started/introduction)
- [Skew Protection](https://nuxtseo.com/docs/skew-protection/getting-started/introduction)
- [AI Ready](https://nuxtseo.com/docs/ai-ready/getting-started/introduction)

### [NuxtSEO Pro](https://nuxtseo.com/pro "Home")

- [Getting Started](https://nuxtseo.com/pro)
- [Dashboard](https://nuxtseo.com/pro/dashboard)
- [Pro MCP](https://nuxtseo.com/docs/nuxt-seo-pro/mcp/installation)

### [Learn SEO](https://nuxtseo.com/learn-seo "Learn SEO")

Nuxt

- [Mastering Meta](https://nuxtseo.com/learn-seo/nuxt/mastering-meta)
- [Controlling Crawlers](https://nuxtseo.com/learn-seo/nuxt/controlling-crawlers)
- [Launch & Listen](https://nuxtseo.com/learn-seo/nuxt/launch-and-listen)
- [Routes & Rendering](https://nuxtseo.com/learn-seo/nuxt/routes-and-rendering)
- [Staying Secure](https://nuxtseo.com/learn-seo/nuxt/routes-and-rendering/security)

Vue

- [Vue SEO Guide](https://nuxtseo.com/learn-seo/vue)
- [Mastering Meta](https://nuxtseo.com/learn-seo/vue/mastering-meta)
- [Controlling Crawlers](https://nuxtseo.com/learn-seo/vue/controlling-crawlers)
- [SPA SEO](https://nuxtseo.com/learn-seo/vue/spa)
- [SSR Frameworks](https://nuxtseo.com/learn-seo/vue/ssr-frameworks)
- [SEO Checklist](https://nuxtseo.com/learn-seo/checklist)
- [Pre-Launch Warmup](https://nuxtseo.com/learn-seo/pre-launch-warmup)
- [Backlinks & Authority](https://nuxtseo.com/learn-seo/backlinks)

### [Tools](https://nuxtseo.com/tools "SEO Tools")

- [Social Share Debugger](https://nuxtseo.com/tools/social-share-debugger)
- [Robots.txt Generator](https://nuxtseo.com/tools/robots-txt-generator)
- [Meta Tag Checker](https://nuxtseo.com/tools/meta-tag-checker)
- [HTML to Markdown](https://nuxtseo.com/tools/html-to-markdown)
- [XML Sitemap Validator](https://nuxtseo.com/tools/xml-sitemap-validator)
- [Schema.org Validator](https://nuxtseo.com/tools/schema-validator)
- [Keyword Research Pro](https://nuxtseo.com/tools/keyword-research)
- [SERP Analyzer Pro](https://nuxtseo.com/tools/serp-analyzer)
- [Domain Rankings Pro](https://nuxtseo.com/tools/domain-rankings)

Copyright © 2023-2026 Harlan Wilton - [MIT License](https://github.com/harlan-zw/nuxt-seo/blob/main/license) · [mdream](https://mdream.dev)