decocms/storefront-skills/seo-sections

deco's apps ships ready-made SEO sections for every major page type, configurable directly via the admin panel. When a site has no SEO section or a custom one that lacks structured data, replace it with the appropriate apps component.

Three page types, three SEO sections

All three are configurable via the deco admin under SEO Type:

Select the correct type in the admin and connect the same data loader already used by the page — the section generates <title>, og:tags, and LD+JSON automatically from that data.

Render mode: async (deferred)

SEO sections should be async/deferred, not SSR. For regular users, metadata is injected into <head> via HTMX head-support after load. For bots, shouldForceRender forces SSR automatically — no extra config needed. See [[deco-bot-rendering]].

HTMX head-support is required

Without this extension, <title> and og:tags never reach <head> for regular users:

{
  "htmx": {
    "version": "1.9.12",
    "extensions": ["head-support"]
  }
}

Common mistakes

Quick audit

# PDP bot view — must have title, og:tags, LD+JSON
curl -s "https://www.store.com/product/p?__decoFBT=0" | grep -E "<title|og:|ld\+json"
 
# PLP bot view
curl -s "https://www.store.com/category?__decoFBT=0" | grep -E "<title|og:|ld\+json"
 
# Check HTMX head-support
grep "head-support" .deco/blocks/site.json