# Nuxt SEO
> Nuxt SEO is a collection of hand-crafted Nuxt Modules to help you rank higher in search engines.
Canonical Origin: https://nuxtseo.com
## LLM Resources
- [Full Content](https://nuxtseo.com/llms-full.txt)
Complete page content in markdown format.
- [MCP](https://nuxtseo.com/mcp)
Model Context Protocol server endpoint for AI agent integration.
## Pages
### Nuxt SEO · All-in-one Technical SEO for Nuxt
Source: https://nuxtseo.com/
Description: Nuxt SEO is a collection of hand-crafted Nuxt Modules to help you rank higher in search engines.
h1. Fully equipped** **Technical SEO** for busy **Nuxters**. **
Nuxt SEO is a collection of [**modules **](https://nuxt.com/modules) that handle all of the technical aspects in growing your sites organic traffic.
[**Get Started **](https://nuxtseo.com/docs/nuxt-seo/getting-started/introduction) [** Install Nuxt SEO **](https://nuxtseo.com/docs/nuxt-seo/getting-started/installation)
[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)
1.
h2. **Put web crawlers to work.**
Providing a robots.txt and sitemap.xml gives web crawlers data on how to index your site.
[Robots **v5.6.7** 7.8M 502 Tame the robots crawling and indexing your site with ease.](https://nuxtseo.com/docs/robots/getting-started/introduction)
[Sitemap **v7.5.0** 9.2M 410 Powerfully flexible XML Sitemaps that integrate seamlessly.](https://nuxtseo.com/docs/sitemap/getting-started/introduction)
2.
h2. **Feed semantic data to hungry bots.**
Robots love data, give them what they want with Schema.org and Open Graph tags.
[Schema.org **v5.0.10** 3.3M 178 The quickest and easiest way to build Schema.org graphs.](https://nuxtseo.com/docs/schema-org/getting-started/introduction)
[SEO Utils **v7.0.19** 1.5M 119 SEO utilities to improve your Nuxt sites discoverability and shareability.](https://nuxtseo.com/docs/seo-utils/getting-started/introduction)
3.
h2. **Humanize it.**
Technical SEO doesn't just involve robots, make sure your site is human friendly too.
[OG Image **v5.1.13** 2.9M 495 Generate OG Images with Vue templates in Nuxt.](https://nuxtseo.com/docs/og-image/getting-started/introduction)
[SEO Utils **v7.0.19** 1.5M 119 SEO utilities to improve your Nuxt sites discoverability and shareability.](https://nuxtseo.com/docs/seo-utils/getting-started/introduction)
4.
h2. **Nurture and watch it flourish.**
Providing a robots.txt and sitemap.xml gives web crawlers data on how to index your site.
[Link Checker **v4.3.9** 2.3M 95 Find and magically fix links that may be negatively effecting your SEO.](https://nuxtseo.com/docs/link-checker/getting-started/introduction)
h2. **Nuxt SEO Principals **
h3. **Delightful Developer Experience**
Full featured modules that do everything you expect and more.
h3. **Zero Config Defaults**
Provide a site URL and all modules are good to go. Fully extensible with config and hooks.
h3. **Integrate with Ecosystem**
Modules integrate with themselves as well as Nuxt Content, Nuxt I18n and Nuxt DevTools.
h3. **For Apps All Shapes and Sizes **
Single Page
Server-Side Generated
Server-Side Rendered
Multi-tenancy
Base URL
Trailing Slashes
h2. **Learn SEO **
Comprehensive guides for technical SEO with code examples and best practices.
[**Nuxt SEO Guide **
Meta tags, sitemaps, robots.txt, Schema.org, and more. Everything you need for Nuxt applications. - Mastering Meta Tags - Controlling Web Crawlers - Routes & Rendering Modes](https://nuxtseo.com/learn-seo/nuxt) [**Vue SEO Guide **
SPA SEO challenges, SSR frameworks comparison, Unhead integration, and Core Web Vitals optimization. - SPA SEO Solutions - SSR Framework Comparison - Vue SEO Checklist](https://nuxtseo.com/learn-seo/vue)
h2. **Free SEO Tools **
Developer-focused tools to debug, validate, and optimize your site's SEO.
[**Social Share Debugger**
Preview how links appear on Twitter, Facebook, LinkedIn, Slack & Discord.](https://nuxtseo.com/tools/social-share-debugger) [**Meta Tag Checker**
Validate title & description length. Preview Google search appearance.](https://nuxtseo.com/tools/meta-tag-checker) [**Robots.txt Generator**
Generate robots.txt with AI crawler presets. Block GPTBot, ClaudeBot & more.](https://nuxtseo.com/tools/robots-txt-generator) [**Schema.org Validator**
Validate JSON-LD & Microdata markup for rich snippets.](https://nuxtseo.com/tools/schema-validator) [**XML Sitemap Validator**
Test sitemap structure & validate against Google requirements.](https://nuxtseo.com/tools/xml-sitemap-validator) [**HTML to Markdown**
Convert webpages to clean markdown for Nuxt Content or LLMs.](https://nuxtseo.com/tools/html-to-markdown) [**Keyword Research**
**Pro ** Find long-tail opportunities with volume & difficulty data.](https://nuxtseo.com/tools/keyword-research) [**SERP Analyzer**
**Pro ** See who ranks for any keyword. Analyze AI Overview & SERP features.](https://nuxtseo.com/tools/serp-analyzer) [**Domain Rankings**
**Pro ** Check keyword positions, search volume & estimated traffic.](https://nuxtseo.com/tools/domain-rankings)
[**View All Tools **](https://nuxtseo.com/tools)
h2. **Technical SEO Audits **
Nuxt SEO provides you with with all the tools needed to help you pass technical SEO audits on Google Lighthouse.
SEO
h2. **Up To Date. Always. **
Nuxt SEO was started at the end of 2022 and has received continuous bug fixes and feature improvements from the community.
6.3K
Commits
1.1K
Issues Closed
103
Contributors
h2. **Loved by Nuxt Developers **
Nuxt SEO was built for the community. Here's what some of them have to say.
**78K downloads**per day, on average
Nuxt SEO is used and trusted by thousands of developers and companies around the world.
2.4M
Downloads/ month
3.2K
Total Stars
h2. **Funded by the community **
Nuxt SEO is completely free and open-source due to the generous support of the community.
[**Become a sponsor **](https://github.com/sponsors/harlan-zw)
**Top Sponsors **
[ **Daniel Roe** roe.dev](https://roe.dev)
**Gold Sponsors **
[ **Johann Schopplich** johannschopplich.com](https://johannschopplich.com)
[ **Massive Monster** massivemonster.co](https://massivemonster.co)
[ **Localazy** localazy.com](https://localazy.com)
[ **SMTP Labs** smtp.dev](https://smtp.dev)
**Backers **
[](https://itinsights.org)
[](https://github.com/mgifford)
[](https://github.com/timhanlon)
[](https://github.com/Idrinth)
[](https://github.com/milos018)
[](https://github.com/aussieboi)
[](https://ducrot.de)
[](https://github.com/just-maik)
[](https://github.com/jpsc)
[](https://froggly.pl)
[](https://reshepe.dev)
[](https://generateads.ai)
[](https://adkit.so)
[](https://github.com/axelparisflashfiscal)
---
### Social Share Debugger - Preview & Clear OG Cache · Nuxt SEO
Source: https://nuxtseo.com/tools/social-share-debugger
Description: Preview how your links appear on Twitter, Facebook, LinkedIn, Slack and Discord. Debug OG tags and clear platform caches instantly.
h1. **Social Share Debugger**
Preview how your links appear on Twitter, Facebook, LinkedIn, Slack and Discord. Debug OG tags and clear platform caches instantly.
h2. **Clear Platform Cache **
h3. **Facebook Sharing Debugger**
Clear Facebook cache and force re-scrape
[**Open Tool **](https://developers.facebook.com/tools/debug/)
h3. **Twitter Card Validator**
Validate and preview Twitter cards
[**Open Tool **](https://cards-dev.twitter.com/validator)
h3. **LinkedIn Post Inspector**
Inspect and refresh LinkedIn previews
[**Open Tool **](https://www.linkedin.com/post-inspector/)
h2. **Why Isn't My OG Image Updating? **
Social platforms cache link previews aggressively to reduce server load. After updating your OG tags, you'll need to manually clear each platform's cache.
h3. **Facebook **
Caches for approximately **30 days**. Force refresh via the [Facebook Sharing Debugger](https://developers.facebook.com/tools/debug/). Click "Scrape Again" to fetch fresh data.
h3. **Twitter/X **
Caches until you request a re-scrape via the [Card Validator](https://cards-dev.twitter.com/validator). Note: The validator UI was removed but the API still works.
h3. **LinkedIn **
Has a particularly sticky cache. Clear via [Post Inspector](https://www.linkedin.com/post-inspector/). May take up to 7 days for cache to fully refresh.
h3. **Pro Tips for OG Images **
- Use **1200x630px** for optimal display across platforms
- Keep important content in the center 800x400px safe zone
- Use absolute URLs for og:image (relative URLs won't work)
- Add cache-busting query params when updating: `?v=2`
h2. **Official References**
[**The Open Graph Protocol**](https://ogp.me/)
Official specification for og:title, og:description, og:image and more.
[**Twitter Cards Documentation**](https://developer.x.com/en/docs/twitter-for-websites/cards/overview/abouts-cards)
Official X/Twitter Cards specification and card types.
[**Facebook Sharing Best Practices**](https://developers.facebook.com/docs/sharing/webmasters/)
Meta's guide to optimizing link shares on Facebook and Instagram.
h2. **Related Resources**
[**OG Image Module**](https://nuxtseo.com/tools/social-share-debugger/docs/og-image/getting-started/introduction) [**Open Graph Guide**](https://nuxtseo.com/tools/social-share-debugger/learn-seo/nuxt/mastering-meta/open-graph) [**Twitter Cards**](https://nuxtseo.com/tools/social-share-debugger/learn-seo/nuxt/mastering-meta/twitter-cards) [**Vue Social Sharing**](https://nuxtseo.com/tools/social-share-debugger/learn-seo/vue/mastering-meta/social-sharing) [**Meta Tag Checker**](https://nuxtseo.com/tools/social-share-debugger/tools/meta-tag-checker)
---
### Meta Tag Checker - Test Title & Description Length · Nuxt SEO
Source: https://nuxtseo.com/tools/meta-tag-checker
Description: Check meta tags from any URL. Validate title and description length. Preview how your page appears in Google search results.
h1. **Meta Tag Checker**
Check meta tags from any URL. Preview how your page appears in Google search results.
h2. **Meta Tag Length Limits **
h3. **Title Tag **
- Keep under 60 characters to avoid truncation
- 51-60 chars have lowest rewrite rates (39-42%)
- Front-load keywords—users may only see first 50
[Learn title best practices ](https://nuxtseo.com/tools/meta-tag-checker/learn-seo/vue/mastering-meta/titles)
h3. **Meta Description **
- Desktop: ~155-160 chars, mobile: ~120
- Google rewrites 62-70% of descriptions
- Front-load value for mobile truncation
[Learn description best practices ](https://nuxtseo.com/tools/meta-tag-checker/learn-seo/vue/mastering-meta/descriptions)
h2. **Why Pixel Width Matters **
Characters have different widths. "iiiiii" is narrower than "WWWWWW". This tool estimates actual pixel width, not just character count, giving you a more accurate picture of how your titles will display.
h2. **Are Your Meta Tags Server-Rendered? **
Search engines need meta tags in the initial HTML response. Client-side rendered meta tags (added by JavaScript after page load) may not be indexed.
**Good news:** This tool fetches your page exactly like a search engine would—no JavaScript execution. If your meta tags appear above, they're server-rendered correctly.
h3. **Manual Check **
1. View Page Source (Ctrl+U / Cmd+U)
2. Search for your tag
3. If it's missing or shows a placeholder, you have an SSR problem
h2. **Solutions by Framework **
Nuxt
Use `useSeoMeta()` or `useHead()` - SSR by default. [Nuxt SEO Docs →](https://nuxtseo.com/tools/meta-tag-checker/docs/nuxt-seo/getting-started/introduction)
Vue
Use [Unhead](https://unhead.unjs.io) with SSR or prerendering. [Vue SEO Guide →](https://nuxtseo.com/tools/meta-tag-checker/learn-seo/vue/mastering-meta)
Next.js
Use `generateMetadata` (App Router) or `<Head>` (Pages Router). [Next.js Docs →](https://nextjs.org/docs/app/building-your-application/optimizing/metadata)
React
Use [react-helmet](https://github.com/nfl/react-helmet) or [Unhead](https://unhead.unjs.io). Requires SSR framework (Next.js, Remix) for SEO.
Astro
Set tags in `<head>` directly or use [@astrojs/sitemap](https://docs.astro.build/en/guides/integrations-guide/sitemap/). SSR by default.
SvelteKit
Use `<svelte:head>` in pages. [Svelte Docs →](https://svelte.dev/docs/svelte/svelte-head)
Remix
Export `meta` function from routes. [Remix Docs →](https://remix.run/docs/en/main/route/meta)
SolidStart
Use `<Title>` and `<Meta>` from [@solidjs/meta](https://docs.solidjs.com/solid-meta).
h2. **Official References**
[**Google: Title Links in Search Results**](https://developers.google.com/search/docs/appearance/title-link)
Official documentation on how Google generates title links and best practices.
[**Google: Control Snippets in Search Results**](https://developers.google.com/search/docs/appearance/snippet)
How Google uses meta descriptions and generates snippets.
[**MDN: <meta> Element Reference**](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/meta)
Complete HTML meta tag specification and attributes.
[**The Open Graph Protocol**](https://ogp.me/)
Official specification for Open Graph meta tags.
h2. **Related Resources**
[**Title Best Practices**](https://nuxtseo.com/tools/meta-tag-checker/learn-seo/vue/mastering-meta/titles) [**Description Best Practices**](https://nuxtseo.com/tools/meta-tag-checker/learn-seo/vue/mastering-meta/descriptions) [**Social Sharing Guide**](https://nuxtseo.com/tools/meta-tag-checker/learn-seo/vue/mastering-meta/social-sharing) [**useSeoMeta Docs**](https://nuxtseo.com/tools/meta-tag-checker/docs/seo-utils/api/use-seo-meta) [**Social Share Debugger**](https://nuxtseo.com/tools/meta-tag-checker/tools/social-share-debugger)
---
### XML Sitemap Validator - Test & Validate Sitemaps · Nuxt SEO
Source: https://nuxtseo.com/tools/xml-sitemap-validator
Description: Validate XML sitemaps for errors, check URL format, and ensure search engine compliance. Test sitemap structure, validate against Google requirements, and optimize crawl efficiency.
h1. **XML Sitemap Validator**
Validate XML sitemaps for errors and ensure search engine compliance. Test sitemap structure and optimize for better crawl efficiency.
h2. **What Makes a Valid Sitemap? **
XML sitemaps help search engines discover and crawl your pages efficiently. A valid sitemap follows specific rules:
- **Proper namespace:** Must include xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
- **Size limits:** Maximum 50,000 URLs and 50MB uncompressed
- **Valid URLs:** Absolute URLs with proper encoding
- **Date format:** W3C datetime format (YYYY-MM-DD)
h2. **Common Sitemap Errors **
Invalid XML
Missing closing tags, incorrect nesting, or unescaped characters (&, <, >). Always escape special characters.
Wrong date
Using formats like "01/15/2024" instead of "2024-01-15". Use W3C datetime format.
Relative URLs
Using "/page" instead of "https://example.com/page". Always use absolute URLs.
Too large
Over 50,000 URLs or 50MB file size. Use sitemap index for large sites.
h2. **Sitemap Best Practices **
h3. **What to Include **
- Important content pages
- Recently updated pages
- Pages hard to discover through navigation
- Canonical versions of URLs only
h3. **What to Exclude **
- Duplicate or near-duplicate pages
- Session ID URLs
- API endpoints
- Admin or private pages
- 404 or error pages
h2. **Submitting Your Sitemap **
Once validated, submit your sitemap to search engines:
1. **Google:** Submit through [Search Console](https://search.google.com/search-console) under Indexing → Sitemaps
2. **Bing:** Submit through [Bing Webmaster Tools](https://www.bing.com/webmasters)
3. **Robots.txt:** Add `Sitemap: https://example.com/sitemap.xml` to your robots.txt
h2. **Dynamic Sitemaps with Nuxt **
Generate sitemaps automatically with the Nuxt Sitemap module:
```
h1. Install the module
npm install @nuxtjs/sitemap
h1. Configure in nuxt.config.ts
export default defineNuxtConfig({
modules: ['@nuxtjs/sitemap'],
sitemap: {
// Auto-discovery enabled by default
exclude: ['/admin/**', '/api/**']
}
})
```
[Learn more about Nuxt Sitemap →](https://nuxtseo.com/tools/xml-sitemap-validator/docs/sitemap/getting-started/introduction)
h2. **Official References**
[**Sitemaps Protocol**](https://www.sitemaps.org/protocol.html)
Official specification for XML sitemaps including format and requirements.
[**Google: Build and Submit a Sitemap**](https://developers.google.com/search/docs/crawling-indexing/sitemaps/build-sitemap)
Google's guide to creating and submitting sitemaps.
[**Google Search Console**](https://search.google.com/search-console)
Submit and monitor your sitemap for indexing.
[**Bing Webmaster Tools**](https://www.bing.com/webmasters)
Submit your sitemap to Bing for indexing.
h2. **Related Resources**
[**Sitemap Module**](https://nuxtseo.com/tools/xml-sitemap-validator/docs/sitemap/getting-started/introduction) [**Robots.txt Module**](https://nuxtseo.com/tools/xml-sitemap-validator/docs/robots/getting-started/introduction) [**Sitemap Guide**](https://nuxtseo.com/tools/xml-sitemap-validator/learn-seo/nuxt/controlling-crawlers/sitemaps) [**Meta Tag Checker**](https://nuxtseo.com/tools/xml-sitemap-validator/tools/meta-tag-checker) [**Nuxt SEO Docs**](https://nuxtseo.com/tools/xml-sitemap-validator/docs/nuxt-seo/getting-started/introduction)
---
### Schema.org Validator - Test Structured Data · Nuxt SEO
Source: https://nuxtseo.com/tools/schema-validator
Description: Validate Schema.org structured data on any website. Test JSON-LD and Microdata markup, find errors, and ensure proper implementation for rich snippets.
h1. **Schema.org Validator**
Validate structured data on any website. Test Schema.org markup, identify errors, and ensure proper implementation for rich snippets.
h2. **What is Schema.org Structured Data? **
Schema.org provides a shared vocabulary that search engines understand. When you add structured data to your pages, you're explicitly telling search engines what your content means, not just what it says.
- **Rich snippets:** Enhanced search results with ratings, prices, availability
- **Better understanding:** Help search engines comprehend your content's context
- **Higher CTR:** Rich results can increase click-through rates by 30%+
h2. **Popular Schema Types **
h3. **Content Types **
- **Article:** News, blog posts, sports articles
- **FAQPage:** Frequently asked questions
- **HowTo:** Step-by-step guides
- **Recipe:** Cooking instructions
h3. **Business Types **
- **Product:** Physical or digital products
- **Organization:** Companies, NGOs, clubs
- **LocalBusiness:** Stores, restaurants
- **SoftwareApplication:** Apps, tools
h2. **JSON-LD Implementation **
JSON-LD is Google's recommended format for structured data. Add it to your page's <head> or <body>:
```
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "Your Article Title",
"author": {
"@type": "Person",
"name": "Author Name"
},
"datePublished": "2024-01-15",
"image": "https://example.com/image.jpg"
}
</script>
```
h2. **Common Validation Errors **
Missing @type
Every schema must specify its type (Article, Product, etc). Always include "@type" property.
Invalid dates
Dates must be in ISO 8601 format (YYYY-MM-DD). Use proper date formatting.
Missing required
Each type has required properties that must be included. Check schema.org documentation.
Invalid URLs
URLs must be absolute and properly formatted. Include full https:// URLs.
h2. **Structured Data with Nuxt **
Use the Nuxt Schema.org module for type-safe structured data:
```
h1. Install the module
npm install @nuxtjs/schema-org
h1. Use in your Vue components
<script setup>
useSchemaOrg([
defineArticle({
headline: 'My Article Title',
author: 'John Doe',
datePublished: new Date('2024-01-15'),
image: '/og-image.jpg'
})
])
</script>
```
[Learn more about Nuxt Schema.org →](https://nuxtseo.com/tools/schema-validator/docs/schema-org/getting-started/introduction)
h2. **Official References**
[**Schema.org Documentation**](https://schema.org/docs/gs.html)
Official getting started guide for implementing structured data.
[**Google Structured Data**](https://developers.google.com/search/docs/appearance/structured-data)
Google's guide to structured data for rich results.
[**Rich Results Test**](https://search.google.com/test/rich-results)
Google's tool for testing structured data and preview rich results.
[**Schema.org Types**](https://schema.org/docs/full.html)
Complete reference of all available Schema.org types and properties.
h2. **Related Resources**
[**Schema.org Module**](https://nuxtseo.com/tools/schema-validator/docs/schema-org/getting-started/introduction) [**Structured Data Guide**](https://nuxtseo.com/tools/schema-validator/learn-seo/nuxt/controlling-crawlers/structured-data) [**Meta Tag Checker**](https://nuxtseo.com/tools/schema-validator/tools/meta-tag-checker) [**Nuxt SEO Docs**](https://nuxtseo.com/tools/schema-validator/docs/nuxt-seo/getting-started/introduction) [**Article Schema Recipe**](https://nuxtseo.com/tools/schema-validator/recipes/schema-org/article)
---
### HTML to Markdown Converter - Convert URLs & HTML · Nuxt SEO
Source: https://nuxtseo.com/tools/html-to-markdown
Description: Convert any webpage or HTML to clean markdown. Extract article content for Nuxt Content, LLMs, or documentation migration.
h1. **HTML to Markdown Converter**
Convert any webpage or HTML to clean markdown. Perfect for Nuxt Content, LLMs, or documentation migration.
**Extract article content only**
Remove navigation, footer, ads
h2. **Convert Any Webpage to Markdown **
Enter a URL to extract and convert the page content to clean markdown.
h3. **How It Works **
Powered by [mdream](https://github.com/harlan-zw/mdream), a fast HTML to Markdown converter.
1. Fetches the webpage HTML
2. Extracts main content (removes nav, footer, ads)
3. Converts HTML elements to markdown syntax
4. Outputs clean, portable markdown
h3. **Use Cases **
- **Documentation migration:** Move docs from legacy CMS to Nuxt Content
- **LLM context:** Feed clean markdown to ChatGPT, Claude, or RAG pipelines
- **Content archival:** Save articles in portable format
- **Blog migration:** Convert WordPress posts to markdown files
h2. **Convert HTML to Markdown for LLMs **
Large language models work better with markdown than HTML:
- **Smaller token count:** Markdown is more compact
- **Cleaner structure:** No style attributes or wrapper divs
- **Better parsing:** LLMs understand markdown headings, lists, links
h4. For RAG Pipelines
1. Scrape source pages
2. Convert to markdown (this tool)
3. Chunk by headings
4. Embed and index
h2. **Official References**
[**CommonMark Specification**](https://commonmark.org/help/)
The standard Markdown syntax reference used by most tools.
[**GitHub Flavored Markdown**](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax)
Extended Markdown syntax with tables, task lists, and strikethrough.
[**Nuxt Content Documentation**](https://content.nuxt.com/)
Use converted Markdown with Nuxt Content for content-driven sites.
h2. **Related Resources**
[**Meta Tag Checker**](https://nuxtseo.com/tools/html-to-markdown/tools/meta-tag-checker) [**Nuxt SEO Docs**](https://nuxtseo.com/tools/html-to-markdown/docs/nuxt-seo/getting-started/introduction) [**llms.txt Guide**](https://nuxtseo.com/tools/html-to-markdown/learn-seo/nuxt/controlling-crawlers/llms-txt) [**AI Ready Module**](https://nuxtseo.com/tools/html-to-markdown/docs/ai-ready/getting-started/introduction) [**Vue SEO Guide**](https://nuxtseo.com/tools/html-to-markdown/learn-seo/vue)
---
### Robots.txt Generator & Tester - Block AI Crawlers · Nuxt SEO
Source: https://nuxtseo.com/tools/robots-txt-generator
Description: Generate robots.txt with AI crawler presets. Test rules against Googlebot, GPTBot, ClaudeBot and 50+ user agents. Validate syntax instantly.
h1. **Robots.txt Generator & Tester**
Generate robots.txt with AI crawler presets. Test rules instantly.
h2. **Rules **
1.
Disallow
*(none) *
Allow
Sitemaps
Content-Usage [IETF](https://datatracker.ietf.org/doc/draft-ietf-aipref-vocab/)
search
train-ai
Content-Signal [Cloudflare](https://blog.cloudflare.com/content-signals-policy/)
search
ai-input
ai-train
"No preference" excludes from output
robots.txt
```
h1. Generated by Nuxt SEO
h1. https://nuxtseo.com/tools/robots-txt-generator
User-agent: *
Allow: /
```
h2. **Test Your Rules **
URL Path to test
User-agent
Access granted!
Matched: User-agent: * Allow: /
h2. **Common User Agents **
h3. **Search Engines**
[Googlebot ](https://developers.google.com/search/docs/crawling-indexing/overview-google-crawlers)
Google Search (28% of bot traffic)
[Bingbot ](https://www.bing.com/webmasters/help/which-crawlers-does-bing-use-8c184ec0)
Microsoft Bing Search
[DuckDuckBot ](https://duckduckgo.com/duckduckbot)
DuckDuckGo Search
[YandexBot ](https://yandex.com/support/webmaster/robot-workings/check-yandex-robots.html)
Yandex Search (Russia)
[Baiduspider ](https://www.baidu.com/search/robots_english.html)
Baidu Search (China)
h3. **AI Crawlers**
[GPTBot ](https://platform.openai.com/docs/bots)
OpenAI model training (7.5% of bot traffic, most blocked bot)
[ChatGPT-User ](https://platform.openai.com/docs/bots)
ChatGPT live browsing
[OAI-SearchBot ](https://platform.openai.com/docs/bots)
ChatGPT Search feature
[ClaudeBot ](https://www.anthropic.com/crawlers-info)
Anthropic model training
[Claude-Web ](https://www.anthropic.com/crawlers-info)
Claude live browsing
[anthropic-ai ](https://www.anthropic.com/crawlers-info)
Anthropic data collection
[CCBot ](https://commoncrawl.org/ccbot)
Common Crawl dataset (Frequently blocked, used by many AI labs)
[Google-Extended ](https://developers.google.com/search/docs/crawling-indexing/overview-google-crawlers#google-extended)
Gemini/Bard training (separate from Search)
[PerplexityBot ](https://docs.perplexity.ai/guides/bots)
Perplexity AI search
Bytespider
TikTok/ByteDance AI
[Amazonbot ](https://developer.amazon.com/amazonbot)
Amazon Alexa training
[cohere-ai ](https://cohere.com/robots)
Cohere model training
[Meta-ExternalAgent ](https://www.facebook.com/externalhit_uatext.php)
Meta AI training
[meta-externalfetcher ](https://www.facebook.com/externalhit_uatext.php)
Meta data fetching
[Applebot-Extended ](https://support.apple.com/en-us/119829)
Apple AI training (not Search)
h3. **Social Platforms**
[facebookexternalhit ](https://developers.facebook.com/docs/sharing/webmasters/web-crawlers/)
Facebook/Meta link previews
[Twitterbot ](https://developer.x.com/en/docs/x-for-websites/cards/guides/getting-started)
Twitter/X link previews
[LinkedInBot ](https://www.linkedin.com/help/linkedin/answer/a521928)
LinkedIn link previews
[Slackbot ](https://api.slack.com/robots)
Slack link previews
Discordbot
Discord link previews
WhatsApp
WhatsApp link previews
TelegramBot
Telegram link previews
Source: [Cloudflare 2025 Bot Traffic Report](https://blog.cloudflare.com/from-googlebot-to-gptbot-whos-crawling-your-site-in-2025/)
h2. **Directives **
h3. **Core Directives **
`User-agent: *`
applies to all crawlers
`Disallow: /`
block entire site
`Allow: /`
explicitly allow (for exceptions)
`Crawl-delay: 10`
wait 10s between requests (Bing/Yandex)
`Sitemap: URL`
specify sitemap location
h3. **Content-Usage **
[IETF](https://datatracker.ietf.org/doc/draft-ietf-aipref-vocab/)
Uses `y`/`n` values
`Content-Usage: search=y`
allow search indexing
`Content-Usage: train-ai=n`
disallow AI model training
Combine: `search=y, train-ai=n`
h3. **Content-Signal **
[Cloudflare](https://blog.cloudflare.com/content-signals-policy/)
Uses `yes`/`no` values
`search=yes`
allow search indexing
`ai-input=no`
disallow live AI answers
`ai-train=no`
disallow model training
h3. **Pattern Matching **
`*`
matches any sequence
`$`
matches end of URL
`/*.pdf`
all .pdf files
`/*.php$`
URLs ending in .php
h2. **Common Patterns **
`Disallow: /admin/`Block /admin/ directory
`Disallow: /*?`Block URLs with query strings
`Disallow: /*.json$`Block all .json files
`Disallow: /private/*`Block everything under /private/
`Allow: /api/public`Allow specific path (exception)
h2. **Block AI Training **
[GPTBot: most blocked bot 2024 →](https://blog.cloudflare.com/from-googlebot-to-gptbot-whos-crawling-your-site-in-2025/)
$ top AI crawlers to block
`GPTBot``ClaudeBot``CCBot``Google-Extended``Bytespider``PerplexityBot`
Google-Extended = Gemini training (not Search)
$ content preference headers
[IETF](https://datatracker.ietf.org/doc/draft-ietf-aipref-vocab/)`Content-Usage: search=y, train-ai=n`
[Cloudflare](https://blog.cloudflare.com/content-signals-policy/)`Content-Signal: search=yes, ai-train=no`
ai-input = live answers ai-train = model training
h2. **Learn More **
[<h2>**Robots.txt Guide**</h2>Complete guide to robots.txt syntax, common patterns, and security considerations.](https://nuxtseo.com/tools/robots-txt-generator/learn-seo/vue/controlling-crawlers/robots-txt) [<h2>**XML Sitemaps**</h2>How sitemaps work with robots.txt to guide crawler discovery.](https://nuxtseo.com/tools/robots-txt-generator/learn-seo/vue/controlling-crawlers/sitemaps) [<h2>**Meta Robots Tags**</h2>Page-level control when robots.txt isn't enough.](https://nuxtseo.com/tools/robots-txt-generator/learn-seo/vue/controlling-crawlers/meta-tags)
h2. **Need Dynamic Robots.txt? **
Generate robots.txt rules dynamically based on routes, environments, or user conditions with the Nuxt Robots module.
[**Explore Nuxt Robots **](https://nuxtseo.com/tools/robots-txt-generator/docs/robots/getting-started/introduction)
**Was this tool helpful? **
Your feedback helps us improve
---
### SEO Tools for Developers · Nuxt SEO
Source: https://nuxtseo.com/tools
Description: Developer tools for SEO. Debug social share cards, generate robots.txt, check meta tags, keyword research, SERP analysis, and more.
h1. **SEO Tools **
Developer utilities for SEO. Pro tools offer 2 free requests/day.
[<h2>**Keyword Research ****Pro **</h2>Find keyword opportunities with volume, difficulty, and intent data.](https://nuxtseo.com/tools/tools/keyword-research)
[<h2>**SERP Analyzer ****Pro **</h2>See who ranks for any keyword and what SERP features are present.](https://nuxtseo.com/tools/tools/serp-analyzer)
[<h2>**Domain Rankings ****Pro **</h2>Check what keywords any domain ranks for in Google.](https://nuxtseo.com/tools/tools/domain-rankings)
[<h2>**Social Share Debugger **</h2>Preview and debug social share cards across Twitter, Facebook, LinkedIn, and more.](https://nuxtseo.com/tools/tools/social-share-debugger)
[<h2>**Robots.txt Generator **</h2>Generate and test robots.txt rules. Block AI crawlers with one click.](https://nuxtseo.com/tools/tools/robots-txt-generator)
[<h2>**Meta Tag Checker **</h2>Check meta tags from any URL. Preview SERP appearance and validate lengths.](https://nuxtseo.com/tools/tools/meta-tag-checker)
[<h2>**HTML to Markdown **</h2>Convert webpages to clean markdown for docs, LLMs, or content migration.](https://nuxtseo.com/tools/tools/html-to-markdown)
[<h2>**XML Sitemap Validator **</h2>Validate XML sitemaps for errors, check URL format, and ensure search engine compliance.](https://nuxtseo.com/tools/tools/xml-sitemap-validator)
[<h2>**Schema.org Validator **</h2>Validate structured data on any website. Test Schema.org markup and ensure proper implementation.](https://nuxtseo.com/tools/tools/schema-validator)
---
### SERP Keyword Research Tool · Nuxt SEO Pro
Source: https://nuxtseo.com/tools/keyword-research
Description: Research keywords with volume, difficulty, and intent data. Find long-tail opportunities and track your research history.
h1. **Keyword Research**
Find keyword opportunities with volume, difficulty, and intent data.
Try these
h2. **Understanding Keyword Metrics **
h3. **Search Volume **
Monthly search volume estimates how many times a keyword is searched. Higher isn't always better—10,000 searches with 0.1% CTR means fewer clicks than 500 searches with 10% CTR.
- 10-100: Very long-tail, specific intent
- 100-1K: Long-tail, good for targeting
- 1K-10K: Medium competition
- 10K+: High competition, broad intent
h3. **Keyword Difficulty **
A 0-100 score estimating how hard it is to rank. Based on backlink profiles of current top-ranking pages. New sites should target 0-30; established sites can compete at 50+.
- 0-30: Easy - achievable with quality content
- 30-50: Medium - needs strong content + some links
- 50-70: Hard - requires authority + link building
- 70+: Very hard - major authority sites only
h2. **Search Intent Types **
Matching search intent is more important than keyword volume. Google ranks pages that best satisfy what searchers want.
h3. **Informational **
"how to", "what is", "guide to" — User wants to learn. Create comprehensive guides, tutorials, explainers.
h3. **Navigational **
Brand names, specific sites — User wants a specific page. Optimize your brand pages and ensure you rank for your own name.
h3. **Commercial **
"best", "vs", "review", "top 10" — User is researching before buying. Create comparison content, reviews, listicles.
h3. **Transactional **
"buy", "price", "discount", "download" — User ready to act. Optimize product/service pages with clear CTAs.
h2. **Finding Quick Wins **
The best keyword opportunities combine decent volume with low competition. Use the "Quick Wins" preset to filter for these automatically.
h3. **Ideal Quick Win Criteria **
- **Volume 100-5,000:** Enough traffic to matter, not so competitive
- **Difficulty under 30:** Achievable with quality content alone
- **Clear intent match:** You can satisfy what searchers want
- **Topic authority:** Related to your site's existing content
h2. **From Keywords to Content **
1. 1.**Cluster related keywords** — Group keywords by topic. One page can rank for dozens of related terms if it covers the topic comprehensively.
2. 2.**Analyze the SERP** — Use the SERP Analyzer to see what's currently ranking. Match the content format that Google prefers.
3. 3.**Create better content** — Don't just match competitors—exceed them. More depth, better examples, clearer structure.
4. 4.**Optimize on-page SEO** — Use keywords naturally in title, H1, first paragraph, and throughout. Add structured data where appropriate.
h2. **Official References**
[**Google Keyword Planner**](https://ads.google.com/home/tools/keyword-planner/)
Google's official tool for keyword research and search volume data.
[**Search Intent Guide**](https://developers.google.com/search/docs/fundamentals/creating-helpful-content)
Google's guidance on understanding and matching search intent.
[**Long-tail Keywords Strategy**](https://ahrefs.com/blog/long-tail-keywords/)
Comprehensive guide to finding and targeting long-tail keywords.
h2. **Related Resources**
[**SERP Analyzer**](https://nuxtseo.com/tools/keyword-research/tools/serp-analyzer) [**Domain Rankings**](https://nuxtseo.com/tools/keyword-research/tools/domain-rankings) [**Structured Data Guide**](https://nuxtseo.com/tools/keyword-research/learn-seo/nuxt/controlling-crawlers/structured-data) [**Nuxt SEO Docs**](https://nuxtseo.com/tools/keyword-research/docs/nuxt-seo/getting-started/introduction)
---
### Vue SEO Guide · Nuxt SEO
Source: https://nuxtseo.com/learn-seo/vue
Description: Complete Vue.js SEO resource. Meta tags, crawl control, SPA solutions, SSR frameworks, and performance monitoring. with Unhead code examples.
h1. **Vue SEO Guide**
Complete Vue.js SEO resource. Meta tags, crawl control, SPA solutions, SSR frameworks, and performance monitoring. with Unhead code examples.
[Harlan Wilton](https://x.com/harlan_zw)10 mins read Published **Nov 3, 2024** Updated **Dec 17, 2025**
**What you'll learn**
- Vue SPAs render empty `<head>` tags. use SSR or prerendering for SEO
- All examples use Unhead, the Vue 3 head manager (vue-meta has no Vue 3 support)
- Google can render JavaScript but other crawlers can't. always verify with View Page Source
Vue SPAs don't work with search engines by default. The `<head>` renders empty, crawlers see a blank page, and your content never gets indexed.
This guide covers everything you need for Vue SEO. from basic meta tags to SSR framework selection to production monitoring. All examples use [**Unhead**](https://unhead.unjs.io/), the Vue 3 head manager that replaced vue-meta.
h2. [Start Here](#start-here)
**New to Vue SEO?** Start with [**Mastering Meta**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/mastering-meta). It covers the fundamentals: titles, descriptions, and social sharing tags with working code examples.
**Need a quick audit?** Use the [**Vue SEO Checklist**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/launch-and-listen/checklist). a pre-launch, post-launch, and ongoing monitoring checklist with links to detailed guides for every item.
**Already know the basics?** Jump to the section that matches your current problem.
h2. [Content Sections](#content-sections)
h3. [[**Mastering Meta**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/mastering-meta)](#mastering-meta)
Meta tags control how your pages appear in search results and social shares. Learn to set titles, descriptions, Open Graph tags, Twitter Cards, and structured data with Unhead.
| **Guide** | **What You'll Learn** |
| --- | --- |
| [**Titles**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/mastering-meta/titles) | Page titles, title templates, character limits |
| [**Descriptions**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/mastering-meta/descriptions) | Meta descriptions, CTR optimization |
| [**Social Sharing**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/mastering-meta/social-sharing) | Open Graph, Twitter Cards, preview images |
| [**Schema.org**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/mastering-meta/schema-org) | Structured data, JSON-LD, eligibility |
| [**Rich Results**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/mastering-meta/rich-results) | Testing tools, what still works after 2023 changes |
| [**Migrating from vue-meta**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/mastering-meta/migrating-vue-meta) | Side-by-side syntax, breaking changes |
h3. [[**Controlling Crawlers**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/controlling-crawlers)](#controlling-crawlers)
Manage how search engines discover and index your pages. Configure robots.txt, sitemaps, canonical URLs, and handle redirects properly.
| **Guide** | **What You'll Learn** |
| --- | --- |
| [**robots.txt**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/controlling-crawlers/robots-txt) | Allow/block crawlers, AI bot blocking |
| [**Sitemaps**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/controlling-crawlers/sitemaps) | XML sitemap generation, submission |
| [**Meta Tags**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/controlling-crawlers/meta-tags) | noindex, nofollow, per-page control |
| [**Canonical URLs**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/controlling-crawlers/canonical-urls) | Duplicate content, parameter handling |
| [**Redirects**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/controlling-crawlers/redirects) | 301 vs 302, redirect chains |
| [**Duplicate Content**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/controlling-crawlers/duplicate-content) | Detection, causes, fixes |
h3. [[**SPA SEO**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/spa)](#spa-seo)
Single page applications have unique SEO challenges. Google can render JavaScript, but other crawlers can't. Learn when SSR is required and what alternatives exist.
| **Guide** | **What You'll Learn** |
| --- | --- |
| [**Prerendering**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/spa/prerendering) | Build-time HTML generation, vite-ssg |
| [**Dynamic Rendering**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/spa/dynamic-rendering) | Serve different content to bots (deprecated but functional) |
| [**Hydration**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/spa/hydration) | Mismatch debugging, SEO implications |
h3. [[**SSR Frameworks**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/ssr-frameworks)](#ssr-frameworks)
Compare Vue server-side rendering options. Each framework has different strengths for SEO, performance, and developer experience.
| **Guide** | **What You'll Learn** |
| --- | --- |
| [**Nuxt vs Quasar**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/ssr-frameworks/nuxt-vs-quasar) | Feature comparison, when to use each |
| [**Vite SSR**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/ssr-frameworks/vite-ssr) | Custom SSR setup, manual control |
| [**VitePress**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/ssr-frameworks/vitepress) | Static sites, documentation, blogs |
h3. [[**Routes & Rendering**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/routes-and-rendering)](#routes-rendering)
URL structure affects rankings. Rendering mode affects indexing. This section covers both.
| **Guide** | **What You'll Learn** |
| --- | --- |
| [**URL Structure**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/routes-and-rendering/url-structure) | Slugs, hyphens, length, keywords |
| [**Pagination**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/routes-and-rendering/pagination) | Self-referencing canonicals, infinite scroll |
| [**Trailing Slashes**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/routes-and-rendering/trailing-slashes) | Consistency, redirect configuration |
| [**Query Parameters**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/routes-and-rendering/query-parameters) | Filter params, tracking params, canonicals |
| [**i18n**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/routes-and-rendering/i18n) | Hreflang, x-default, bidirectional links |
| [**404 Pages**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/routes-and-rendering/404-pages) | Soft 404s, proper status codes |
| [**Dynamic Routes**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/routes-and-rendering/dynamic-routes) | Route params, per-route meta tags |
| [**Rendering Modes**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/routes-and-rendering/rendering) | SSR vs SSG vs SPA comparison |
h3. [[**Launch & Listen**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/launch-and-listen)](#launch-listen)
Deploy your site and monitor its search performance. Set up tracking, debug indexing issues, and handle site migrations.
| **Guide** | **What You'll Learn** |
| --- | --- |
| [**Going Live**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/launch-and-listen/going-live) | First deployment, SSR verification |
| [**Search Console**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/launch-and-listen/search-console) | Verification, reports, URL inspection |
| [**Core Web Vitals**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/launch-and-listen/core-web-vitals) | LCP, INP, CLS optimization for Vue |
| [**Indexing Issues**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/launch-and-listen/indexing-issues) | "Crawled not indexed" fixes |
| [**SEO Monitoring**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/launch-and-listen/seo-monitoring) | Analytics, rank tracking, alerts |
| [**Site Migration**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/launch-and-listen/site-migration) | Domain moves, redirects, recovery |
| [**IndexNow**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/launch-and-listen/indexnow) | Instant indexing for Bing/Yandex |
| [**Debugging**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/launch-and-listen/debugging) | Common Vue SEO issues, hydration errors |
h2. [Quick Reference: SEO Checklist](#quick-reference-seo-checklist)
The [**Vue SEO Checklist**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/launch-and-listen/checklist) provides a structured audit path:
- **Pre-launch** . SSR configured, meta tags set, URLs structured, crawlers controlled
- **Post-launch** . Search Console verified, indexing confirmed, performance passing
- **Ongoing** . Weekly GSC reviews, monthly monitoring, quarterly audits
h2. [Vue vs Nuxt](#vue-vs-nuxt)
This guide covers **plain Vue** applications using Vue Router and Unhead. If you're using **Nuxt**, much of this is handled automatically.
Nuxt provides:
- SSR by default
- File-based routing with automatic meta tag handling
- [**Nuxt SEO module**](https://nuxtseo.com/learn-seo/vue/docs/nuxt-seo/getting-started/introduction) for sitemaps, robots.txt, OG images
- Built-in canonical URLs and sitemap generation
[**See the Nuxt SEO guide →**](https://nuxtseo.com/learn-seo/vue/learn-seo/nuxt)
h2. [Why Vue SPAs Fail SEO](#why-vue-spas-fail-seo)
Vue SPAs render content client-side. The initial HTML looks like this:
```
<!DOCTYPE html>
<html>
<head>
<!-- Empty - no meta tags -->
</head>
<body>
<div id="app"></div>
<script src="/app.js"></script>
</body>
</html>
```
Search engines need meta tags and content in the initial HTML. Google can execute JavaScript to render your page, but:
- Rendering is [**queued separately**](https://developers.google.com/search/docs/crawling-indexing/javascript/javascript-seo-basics) from crawling
- Other crawlers (Bing, social platforms) don't render JavaScript
- Social preview cards (Twitter, Facebook, Slack) read initial HTML only
- Performance suffers. users wait for JavaScript before seeing content
**Solutions:**
- [**SSR frameworks**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/ssr-frameworks) render HTML on the server
- [**Prerendering**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/spa/prerendering) generates HTML at build time
- [**Dynamic rendering**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/spa/dynamic-rendering) serves pre-rendered HTML to bots (deprecated but functional)
h2. [Common Mistakes](#common-mistakes)
**Using vue-meta in Vue 3** . vue-meta never shipped Vue 3 support. Use [**Unhead**](https://unhead.unjs.io/) instead. [**Migration guide**](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/mastering-meta/migrating-vue-meta).
**Skipping SSR verification** . View Page Source on your deployed site. If meta tags are missing, crawlers see nothing.
**Relative OG image URLs** . Social platforms need absolute URLs (`https://site.com/og.png`), not relative paths (`/og.png`).
**Template meta descriptions** . "Welcome to {page}" descriptions hurt click-through rates. Write unique descriptions per page.
**Ignoring Search Console** . GSC shows exactly what Google sees. Check the Page Indexing report for excluded pages.
h2. [External Resources](#external-resources)
- [**Google JavaScript SEO Basics**](https://developers.google.com/search/docs/crawling-indexing/javascript/javascript-seo-basics)
- [**Unhead Documentation**](https://unhead.unjs.io/)
- [**Vue Router History Mode**](https://router.vuejs.org/guide/essentials/history-mode.html)
- [**Vue.js SSR Guide**](https://vuejs.org/guide/scaling-up/ssr.html)
---
[**Mastering Meta** Set up meta tags in Vue 3 with Unhead. Covers titles, descriptions, Open Graph, Twitter Cards, and Schema.org with SSR patterns.](https://nuxtseo.com/learn-seo/vue/learn-seo/vue/mastering-meta)
**On this page**
- [Start Here](#start-here)
- [Content Sections](#content-sections)
- [Quick Reference: SEO Checklist](#quick-reference-seo-checklist)
- [Vue vs Nuxt](#vue-vs-nuxt)
- [Why Vue SPAs Fail SEO](#why-vue-spas-fail-seo)
- [Common Mistakes](#common-mistakes)
- [External Resources](#external-resources)
---
### Nuxt SEO Guide · Nuxt SEO
Source: https://nuxtseo.com/learn-seo/nuxt
Description: Complete Nuxt SEO resource. Meta tags, crawl control, rendering modes, and performance monitoring. Powered by the Nuxt SEO ecosystem.
h1. **Nuxt SEO Guide**
Complete Nuxt SEO resource. Meta tags, crawl control, rendering modes, and performance monitoring. Powered by the Nuxt SEO ecosystem.
[Harlan Wilton](https://x.com/harlan_zw)8 mins read Published **Nov 3, 2024** Updated **Jan 4, 2026**
Nuxt handles SEO by default. Meta tags work out of the box, pages render on the server, and the [**Nuxt SEO module**](https://nuxtseo.com/learn-seo/nuxt/docs/nuxt-seo/getting-started/introduction) automates sitemaps, robots.txt, Open Graph images, and structured data with zero configuration.
This guide covers everything you need for production-grade Nuxt SEO, from basic meta tags to hybrid rendering to search performance monitoring.
h2. [All-in-One Solution](#all-in-one-solution)
The Nuxt SEO ecosystem provides modules for every SEO requirement. Install the full package or pick individual modules:
[Nuxt SEO **v3.3.0** 2.1M 1.3K The all-in-one module that brings it all together.](https://nuxtseo.com/learn-seo/nuxt/docs/nuxt-seo/getting-started/introduction)
The meta-module includes sitemaps, robots.txt, OG images, schema.org, and 20+ utilities. Or install modules individually:
[Sitemap **v7.5.0** 9.2M 410 Powerfully flexible XML Sitemaps that integrate seamlessly.](https://nuxtseo.com/learn-seo/nuxt/docs/sitemap/getting-started/introduction) [Robots **v5.6.7** 7.8M 502 Tame the robots crawling and indexing your site with ease.](https://nuxtseo.com/learn-seo/nuxt/docs/robots/getting-started/introduction) [OG Image **v5.1.13** 2.9M 495 Generate OG Images with Vue templates in Nuxt.](https://nuxtseo.com/learn-seo/nuxt/docs/og-image/getting-started/introduction) [Schema.org **v5.0.10** 3.3M 178 The quickest and easiest way to build Schema.org graphs.](https://nuxtseo.com/learn-seo/nuxt/docs/schema-org/getting-started/introduction) [SEO Utils **v7.0.19** 1.5M 119 SEO utilities to improve your Nuxt sites discoverability and shareability.](https://nuxtseo.com/learn-seo/nuxt/docs/seo-utils/getting-started/introduction) [Site Config **v3.2.14** 8.9M 75 Powerful build and runtime shared site configuration for Nuxt modules.](https://nuxtseo.com/learn-seo/nuxt/docs/site-config/getting-started/introduction)
h2. [Start Here](#start-here)
**New to Nuxt SEO?** Start with [**Mastering Meta**](https://nuxtseo.com/learn-seo/nuxt/learn-seo/nuxt/mastering-meta). It covers the fundamentals: titles, descriptions, and social sharing tags with working code examples.
**Need a quick audit?** Use the [**Nuxt SEO Checklist**](https://nuxtseo.com/learn-seo/nuxt/learn-seo/nuxt/checklist): a pre-launch, post-launch, and ongoing monitoring checklist with links to detailed guides for every item.
**Already know the basics?** Jump to the section that matches your current need.
h2. [Content Sections](#content-sections)
h3. [[**Mastering Meta**](https://nuxtseo.com/learn-seo/nuxt/learn-seo/nuxt/mastering-meta)](#mastering-meta)
Meta tags control how your pages appear in search results and social shares. Nuxt provides `useHead()`, `useSeoMeta()`, and `defineOgImage()` composables, all auto-imported and SSR-ready.
| **Guide** | **What You'll Learn** |
| --- | --- |
| [**Titles**](https://nuxtseo.com/learn-seo/nuxt/learn-seo/nuxt/mastering-meta/titles) | Page titles, title templates, character limits |
| [**Descriptions**](https://nuxtseo.com/learn-seo/nuxt/learn-seo/nuxt/mastering-meta/descriptions) | Meta descriptions, CTR optimization |
| [**Open Graph**](https://nuxtseo.com/learn-seo/nuxt/learn-seo/nuxt/mastering-meta/open-graph) | Social preview images, OG tags |
| [**Twitter Cards**](https://nuxtseo.com/learn-seo/nuxt/learn-seo/nuxt/mastering-meta/twitter-cards) | Twitter-specific meta tags |
| [**Schema.org**](https://nuxtseo.com/learn-seo/nuxt/learn-seo/nuxt/mastering-meta/schema-org) | Structured data with `useSchemaOrg()` |
| [**Slack**](https://nuxtseo.com/learn-seo/nuxt/learn-seo/nuxt/mastering-meta/slack) | Unfurl configuration for Slack |
h3. [[**Controlling Crawlers**](https://nuxtseo.com/learn-seo/nuxt/learn-seo/nuxt/controlling-crawlers)](#controlling-crawlers)
Manage how search engines discover and index your pages. Nuxt modules automate robots.txt, sitemaps, and canonical URLs, or configure manually for full control.
| **Guide** | **What You'll Learn** |
| --- | --- |
| [**robots.txt**](https://nuxtseo.com/learn-seo/nuxt/learn-seo/nuxt/controlling-crawlers/robots-txt) | Module config, AI bot blocking |
| [**Sitemaps**](https://nuxtseo.com/learn-seo/nuxt/learn-seo/nuxt/controlling-crawlers/sitemaps) | Automatic generation, dynamic routes |
| [**Meta Tags**](https://nuxtseo.com/learn-seo/nuxt/learn-seo/nuxt/controlling-crawlers/meta-tags) | noindex, nofollow, per-page control |
| [**Canonical URLs**](https://nuxtseo.com/learn-seo/nuxt/learn-seo/nuxt/controlling-crawlers/canonical-urls) | Duplicate content prevention |
| [**Redirects**](https://nuxtseo.com/learn-seo/nuxt/learn-seo/nuxt/controlling-crawlers/redirects) | 301 vs 302, `routeRules` config |
h3. [[**Routes & Rendering**](https://nuxtseo.com/learn-seo/nuxt/learn-seo/nuxt/routes-and-rendering)](#routes-rendering)
File-based routing makes URLs clean by default. Hybrid rendering with `routeRules` lets you SSR, SSG, or SPA on a per-route basis.
| **Guide** | **What You'll Learn** |
| --- | --- |
| [**Rendering Modes**](https://nuxtseo.com/learn-seo/nuxt/learn-seo/nuxt/routes-and-rendering/rendering) | SSR vs SSG vs SPA, `routeRules` |
| [**Trailing Slashes**](https://nuxtseo.com/learn-seo/nuxt/learn-seo/nuxt/routes-and-rendering/trailing-slashes) | Configuration, redirect handling |
h3. [[**Launch & Listen**](https://nuxtseo.com/learn-seo/nuxt/learn-seo/nuxt/launch-and-listen)](#launch-listen)
Deploy your site and monitor its search performance. Set up tracking, debug indexing issues, and handle site migrations.
| **Guide** | **What You'll Learn** |
| --- | --- |
| [**Going Live**](https://nuxtseo.com/learn-seo/nuxt/learn-seo/nuxt/launch-and-listen/going-live) | First deployment, SSR verification |
| [**Search Console**](https://nuxtseo.com/learn-seo/nuxt/learn-seo/nuxt/launch-and-listen/search-console) | Verification, reports, URL inspection |
| [**Core Web Vitals**](https://nuxtseo.com/learn-seo/nuxt/learn-seo/nuxt/launch-and-listen/core-web-vitals) | LCP, INP, CLS optimization for Nuxt |
| [**Indexing Issues**](https://nuxtseo.com/learn-seo/nuxt/learn-seo/nuxt/launch-and-listen/indexing-issues) | "Crawled not indexed" fixes |
| [**SEO Monitoring**](https://nuxtseo.com/learn-seo/nuxt/learn-seo/nuxt/launch-and-listen/seo-monitoring) | Analytics, rank tracking, alerts |
| [**Site Migration**](https://nuxtseo.com/learn-seo/nuxt/learn-seo/nuxt/launch-and-listen/site-migration) | Domain moves, redirects, recovery |
| [**IndexNow**](https://nuxtseo.com/learn-seo/nuxt/learn-seo/nuxt/launch-and-listen/indexnow) | Instant indexing for Bing/Yandex |
| [**Debugging**](https://nuxtseo.com/learn-seo/nuxt/learn-seo/nuxt/launch-and-listen/debugging) | Common Nuxt SEO issues, hydration errors |
h2. [Quick Reference: SEO Checklist](#quick-reference-seo-checklist)
The [**Nuxt SEO Checklist**](https://nuxtseo.com/learn-seo/nuxt/learn-seo/nuxt/checklist) provides a structured audit path:
- **Pre-launch**: Meta tags set, URLs structured, crawlers configured, modules installed
- **Post-launch**: Search Console verified, indexing confirmed, performance passing
- **Ongoing**: Weekly GSC reviews, monthly monitoring, quarterly audits
h2. [Why Nuxt Works for SEO](#why-nuxt-works-for-seo)
Nuxt renders pages on the server by default. This means meta tags and content appear in the initial HTML that search engines and social platforms read:
```
<!DOCTYPE html>
<html>
<head>
<title>Your Page Title