Troubleshooting Nuxt Schema.org

Debugging

Nuxt DevTools

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

This will give you your Schema.org graph and handy links to test it.

This is enabled by default in development, simply navigate to the Schema.org tab.

If you use the Schema.org DevTools panel, install the optional host module:

pnpm add -D nuxtseo-devtools-host@^1

Restart your development server after installation. The module loads the host automatically. You do not need to add it to modules.

Debug Config

You can enable the debug option which will give you more granular log output.

The /__schema-org__/debug.json endpoint is available by default in development mode (or when debug is enabled), containing the raw config used to generate the Schema.org nodes.

External Debugging Tools

You can test your Schema.org using the following tools:

• Google Rich Results Test
• Schema.org Validator

Valid markup has no rich result

Validation checks the current markup. It does not prove Google has processed the change or selected a rich result. Google's structured data policies explain that valid markup does not guarantee a rich result.

Check crawl and search appearance evidence separately. Google Search timelines explains how Google processes changes and why reported times are not deadlines.

Debugging Tools

• Schema.org Validator - Validate JSON-LD and Microdata markup, find errors, and ensure proper implementation for rich snippets

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:

• Basic