Troubleshooting Nuxt Sitemap

Debugging

Nuxt DevTools

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

This will show you all of your sitemaps and the sources used to generate it.

Debug Endpoint

If you prefer looking at the raw data, you can use the debug endpoint. This is only enabled in development unless you enable the debug option.

Visit /__sitemap__/debug.json within your browser, this is the same data used by Nuxt DevTools.

Debugging Prerendering

If you're trying to debug the prerendered sitemap, you should enable the debug option and check your output for the file .output/public/__sitemap__/debug.json.

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 playgrounds:

• Dynamic URLs
• i18n
• Manual Chunking
• Nuxt Content Document Driven

Troubleshooting FAQ

Why is my browser not rendering the XML properly?

When disabling the XSL (XML Stylesheet) in, the XML will be rendered by the browser.

If you have a i18n integration, then it's likely you'll see your sitemap look raw text instead of XML.

This is a browser bug in parsing the xhtml namespace which is required to add localised URLs to your sitemap. There is no workaround besides re-enabled the XSL.

Google Search Console shows Error when submitting my Sitemap?

Seeing "Error" when submitting a new sitemap is common. This is because Google previously crawled your site for a sitemap and found nothing.

If your sitemap is validating correctly, then you're all set. It's best to way a few days and check back. In nearly all cases, the error will resolve itself.