The SEO topic covers how the theme handles search engine optimization and analytics — from metadata generation and structured data through sitemap configuration and analytics integration. These capabilities ensure content is discoverable and measurable without manual per-page configuration.
Who this is for
- Implementors — configuring SEO defaults, sitemap behavior, and analytics integration for a site instance.
- Developers — extending metadata generation, adding structured data types, or integrating new analytics providers.
- AI agents — generating content with correct frontmatter fields that feed into SEO metadata and Open Graph tags.
- Editors — understanding how title, description, and other frontmatter fields affect search engine visibility and social sharing.
Key concepts
- Metadata from frontmatter — SEO metadata (title tags, meta descriptions, Open Graph tags) is generated automatically from content frontmatter. Well-written titles and descriptions improve search visibility without extra configuration.
- Sitemap and robots — the build produces a sitemap from published (non-draft) content. Draft and noindex pages are excluded automatically.
- Structured data — JSON-LD structured data can be attached to pages for enhanced search result display (breadcrumbs, articles, organization info).
- Analytics integration — analytics scripts are configured at the site level and injected via the base layout. No per-page setup is required.
In This Topic
- Analytics & Consent — Consent banner configuration, consent states, script injection lifecycle, trackEvent() usage, custom snippets, and consent revocation.
- Redirects — How to configure URL redirects using the global manifest and content-level frontmatter, including conflict handling and query parameter behavior.
- SEO and Analytics — SEO metadata requirements, the SEO component contract, and analytics/privacy compliance guidance including CCPA.