TECHNICAL · SEO GLOSSARY
Preview Mode (Headless CMS SEO)
A rendering mode in headless CMS setups that allows content editors to preview unpublished content by bypassing the static cache — which must be correctly separated from the production rendering path to avoid accidentally indexing preview content or exposing unpublished content to Googlebot.
Definition
Preview mode is a feature of headless CMS setups (particularly Next.js\'s "Draft Mode" / legacy "Preview Mode") that allows content editors to view unpublished or draft CMS content rendered on the live frontend before it is published. Preview mode typically works by: (1) A preview URL or token is generated by the CMS when the editor clicks "Preview". (2) The frontend detects the preview session (via a cookie or URL parameter). (3) The frontend fetches the unpublished content from the CMS API and renders it live, bypassing the static HTML cache. (4) The editor sees an accurate preview of how the content will look when published. SEO considerations for preview mode: (1) **Noindex on preview pages** — preview URLs should serve `<meta name="robots" content="noindex">` to prevent Googlebot from indexing draft content. In Next.js Draft Mode, the preview mode cookie is set by a secure API route and is not accessible to Googlebot, so Googlebot should not enter preview mode. However, if preview URLs are shared (e.g., editor shares preview link for stakeholder review) and those URLs are crawlable, they should be explicitly noindexed. (2) **Canonical management in preview** — the preview-rendered page should not declare itself as the canonical URL in production. Canonical tags in preview mode pages should either be suppressed or point to the expected production URL. (3) **Performance not representative** — preview mode pages are SSR (generated fresh on each request) rather than statically served from CDN, so their performance characteristics are not representative of production. CrUX data from DeepSEOAnalysis reflects production CDN-served performance, not preview mode performance.
Why it matters for SEO
Preview mode is a content workflow feature, but misconfigured preview URLs can cause SEO issues: draft content accidentally indexed, canonical mismatches between preview and production URLs, or performance metrics skewed by preview-mode SSR. Correctly separating preview rendering from production rendering paths prevents these issues while maintaining the editorial workflow benefit of live content preview.
How DeepSEOAnalysis checks this
DeepSEOAnalysis audits the publicly accessible production URL, not preview-mode URLs (which require authentication tokens that DeepSEOAnalysis doesn\'t have access to). The audit confirms production-URL canonical configuration, robots directive, and structured data — providing a production-state audit independent of preview mode state.
GLOSSARY
Related terms
technical
Decoupled SEO
The full set of SEO considerations specific to decoupled (headless) web architectures — where content management and content presentation are separate systems — including rendering strategy, structured data implementation in the frontend layer, canonical management, and AI crawler access.
Read definition →technical
SSR vs SSG (SEO)
The choice between server-side rendering (generating HTML per request at the server) and static site generation (pre-building HTML at deploy time) — both produce SEO-safe server-rendered HTML, but with different trade-offs in content freshness, performance, and infrastructure cost.
Read definition →technical
API-First SEO
The SEO strategy for sites built on API-first (headless) architectures — where content is managed via CMS API and rendered by a separate frontend — requiring explicit implementation of meta tags, canonical tags, and structured data in the frontend layer rather than via CMS plugins.
Read definition →technical
Composable CMS
A content management architecture that assembles functionality from multiple specialised best-of-breed services (headless CMS for content, commerce engine for products, search service for discovery) rather than relying on a single monolithic platform — creating flexible but SEO-complex multi-system architectures.
Read definition →technical
Robots.txt
A text file at the root of a domain that tells crawlers which pages or sections to access or avoid.
Read definition →See how your site scores on Preview Mode (Headless CMS SEO).
The free DeepSEOAnalysis audit checks preview mode (headless cms seo) and 100+ other signals. Full report, no signup.
Run a free audit →