---
title: "Checking Links on Build"
description: "Configure link checking during Nuxt build process and CI integration."
canonical_url: "https://nuxtseo.com/docs/link-checker/guides/build-scans"
last_updated: "2026-05-25T04:25:13.986Z"
---

## Introduction

By default, links will be scanned when you run your build.

## Throwing Build Errors

When building and deploying your app in a CI, you may like to disable the deployment if
the scanner finds broken links.

To do so you can enable the `failOnError` option. This will exit the process with a non-zero exit code.

```ts
export default defineNuxtConfig({
  linkChecker: {
    failOnError: true,
  },
})
```

## Generating Reports

Check the [Generate Reports](/docs/link-checker/guides/generating-reports) guide for more details.

## Disabling Build Scans

If you want to disable build link scanning, you can set `runOnBuild` to `false` in your `nuxt.config`:

```ts
export default defineNuxtConfig({
  linkChecker: {
    runOnBuild: false,
  },
})
```