SEO Not Applying
Overview
Marketplace assembles SEO metadata from multiple Sanity sources using a strict priority order.
Higher levels completely replace the same field from lower levels.
SEO priority order
Lowest to highest priority:
- Project default SEO (site-wide fallback)
- Location SEO default (location detail pages)
- Route SEO default (applies across all paths on a route, read-only)
- Page SEO (requires overrideSEO: true on the Page)
- Route SEO override (requires overrideSEO: true on the Route)
- Path SEO override (most granular)
Causes and fixes
Project default is showing instead of Page SEO
Cause:
- overrideSEO is not enabled on the Page document.
Fix:
- Enable overrideSEO on the Page.
- Populate title and description.
- Publish.
Route override is winning over Page SEO
Cause:
- overrideSEO is enabled on the Route.
Route override takes precedence over Page SEO.
Fix:
- If the Page should control SEO, disable overrideSEO on the Route.
- If the Route should control SEO, update the Route-level values and publish.
OG image is missing in social shares
Cause:
- ogImage is empty in the SEO object.
Fix:
- Populate ogImage and publish.
Note:
- Social platforms cache OG metadata aggressively.
JSON-LD is missing or incorrect
JSON-LD is generated by layout type.
Mapping:
- contentBlockDefault: WebPage schema
- SRP: vehicle listing schema
- VDP: vehicle schema
- Location detail: LocalBusiness schema
How to verify:
- Use View Page Source and search for application/ld+json.
Common causes:
- If JSON-LD is missing on a VDP, the vehicle record may be missing required fields from the DMS feed.
- If JSON-LD is missing on an SRP with zero results, this is expected behavior.
SEO changes are not visible yet
SEO changes follow the same cache propagation behavior as content changes.
Fix:
- Wait 5 minutes after publishing.
- Check View Page Source.
How to interpret results:
- If View Page Source shows new metadata and the browser shows old values, it is browser caching. Hard refresh.
- If View Page Source shows old metadata, edge cache invalidation has not completed.
Google is showing old metadata
Cause:
- Search engines update on indexing schedules.
Fix:
- Use URL Inspection in Google Search Console to request a recrawl after the live site updates.