---
title: "Troubleshooting Nuxt Site Config"
description: "Debug Nuxt Site Config issues using DevTools, config options, and minimal reproductions."
canonical_url: "https://nuxtseo.com/docs/site-config/getting-started/troubleshooting"
last_updated: "2026-05-25T12:21:57.155Z"
---

## Debugging

### Nuxt DevTools

The best tool for debugging is the Nuxt DevTools integration with Nuxt Site Config.

This will show you the current site config.

### Debug Config

Nuxt Site Config comes with a Nuxt DevTools integration. The easiest way to debug is to open your DevTools
and navigate to the Site Config tab.

If you'd like to debug outside of development, you will need to enable the debug mode.

```ts [nuxt.config.ts]
export default defineNuxtConfig({
  site: {
    debug: true,
  },
})
```

### Debugging Runtime

Visit the endpoint `/__site-config__/debug.json` to see the current site config debug output.

### Debugging Build Time

The build step generates a static file at `/__site-config__/debug.json`.

You can view this file to see the build time site config debug output.

## Submitting an Issue

When submitting an issue, it's important to provide as much information as possible.

The easiest way to do this is to create a minimal reproduction using the [StackBlitz](https://stackblitz.com) playgrounds:

- [Basic](https://stackblitz.com/edit/nuxt-starter-zycxux?file=public%2F_robots.txt)

## Debugging Tools

- [Meta Tag Checker](/tools/meta-tag-checker) - Verify site URL appears correctly in meta tags