Config · Nuxt Link Checker · 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/link-checker/getting-started/introduction)

[API](https://nuxtseo.com/docs/link-checker/api/config)

[Releases](https://nuxtseo.com/docs/link-checker/releases/v5)

Link Checker

- [Switch to Link Checker](https://nuxtseo.com/docs/link-checker/getting-started/introduction)
- [Switch to Nuxt SEO](https://nuxtseo.com/docs/nuxt-seo/getting-started/introduction)
- [Switch to Robots](https://nuxtseo.com/docs/robots/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 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`` /`

v5.0.8

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

### Nuxt API

- [nuxt.config.ts](https://nuxtseo.com/docs/link-checker/api/config)

Nuxt API

# Config

[Copy for LLMs](https://nuxtseo.com/docs/link-checker/api/config.md)

## [`enabled`](#enabled)

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

Whether to scan links.

## [`skipInspections`](#skipinspections)

- Type: `string[]`
- Default: `[]`

An array of inspection names to skip.

See [Link Checking Rules](https://nuxtseo.com/docs/link-checker/guides/rules) for a list of inspections.

## [`fetchTimeout`](#fetchtimeout)

- Type: `number`
- Default: `10000`

How long to wait for a response before timing out.

## [`report`](#report)

- Type: `{ html?: boolean; markdown?: boolean; json?: boolean; storage?: string | CreateStorageOptions; publish?: boolean }`
- Default: `undefined`

Reports to generate on build.

The `storage` option controls where report files are written. Provide a path relative to the Nuxt root or an `unstorage` options object. By default, reports are written to the `.output` directory.

See the [Generate Reports](https://nuxtseo.com/docs/link-checker/guides/generating-reports) guide for more details.

## [`showLiveInspections`](#showliveinspections)

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

Show inspections as they are run in development. When enabled, link inspection results appear as squiggly underlines directly on the page.

## [`runOnBuild`](#runonbuild)

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

Whether to run the link checker on build.

## [`failOnError`](#failonerror)

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

If set to `true`, the build will fail if the scanner finds any broken links.

## [`excludeLinks`](#excludelinks)

- Type: `(string | RegExp)[]`
- Default: `[/^\/_/]`

Links to exclude from inspection. Supports exact matches, wildcard patterns (using radix3), and regular expressions.

**Pattern Types:**

- Exact match: `/about`
- Wildcard: `/admin/**` (all admin routes), `/api/*` (direct children only)
- RegExp: `/^\/blog\/\d+$/` (blog posts with numeric IDs)
- External: `https://example.com/**`

Useful for routes that aren't prerendered but are known to be valid, or external links you don't want checked.

## [`fetchRemoteUrls`](#fetchremoteurls)

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

Whether remote (external) URLs should be fetched during link checking. When enabled, the module checks if you are online before fetching. Disable this if you are working offline or want to skip external URL validation.

## [`strictNuxtContentPaths`](#strictnuxtcontentpaths)

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

Enable when your `@nuxt/content` files match your pages. This automatically detects link sources for the current page, similar to using `@nuxt/content` with `documentDriven: true`.

## [`excludePages`](#excludepages)

- Type: `(string | RegExp)[]`
- Default: `[]`

Pages to exclude from link checking entirely. When a page matches, none of its links will be inspected.

Supports the same pattern types as `excludeLinks`: exact strings, wildcards (using radix3), and regular expressions.

See the [Exclude Pages](https://nuxtseo.com/docs/link-checker/guides/exclude-pages) guide for more details.

## [`debug`](#debug)

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

Enable to see debug logs.

[Edit this page](https://github.com/harlan-zw/nuxt-link-checker/edit/main/docs/content/4.api/0.config.md)

[Markdown For LLMs](https://nuxtseo.com/docs/link-checker/api/config.md)

Did this page help you?

[ESLint Integration Validate links in your editor with ESLint rules that check against your app's routes and sitemap.](https://nuxtseo.com/docs/link-checker/guides/eslint) [v5.0.0 Release notes for v5.0.0 of Nuxt Link Checker.](https://nuxtseo.com/docs/link-checker/releases/v5)

On this page

- [enabled](#enabled)
- [skipInspections](#skipinspections)
- [fetchTimeout](#fetchtimeout)
- [report](#report)
- [showLiveInspections](#showliveinspections)
- [runOnBuild](#runonbuild)
- [failOnError](#failonerror)
- [excludeLinks](#excludelinks)
- [fetchRemoteUrls](#fetchremoteurls)
- [strictNuxtContentPaths](#strictnuxtcontentpaths)
- [excludePages](#excludepages)
- [debug](#debug)

[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 Idea Generator](https://nuxtseo.com/tools/keyword-generator)
- [Keyword Research](https://nuxtseo.com/tools/keyword-research)
- [SERP Analyzer](https://nuxtseo.com/tools/serp-analyzer)
- [Domain Rankings](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)