Skip to main content

Hyvä

Works out of the box. No hyva-themes/magento2-*-compat module required.

Why it just works​

Every storefront template the SEO Suite ships is pure server-rendered HTML — no <script> tags except the JSON-LD ones (which are non-executable data blocks even under strict CSP). No Knockout templates, no RequireJS modules, no jQuery dependencies.

The injection point is the standard Magento head.additional container, which Hyvä themes also expose. Because Hyvä uses Magento's normal layout XML pipeline, our view/frontend/layout/default.xml is consumed unchanged.

ConcernStatus on Hyvä
Canonical tag✅ Renders normally
Hreflang tags✅ Renders normally
Open Graph + Twitter✅ Renders normally
JSON-LD structured data✅ Renders normally (<script type="application/ld+json"> is universally allowed)
Layered-nav noindex observer✅ Fires on layout_generate_blocks_after — same event whether Luma or Hyvä
Meta-template observer✅ Same — works on pageConfig not on Luma block hierarchy
Per-store robots.txt plugin✅ Plugins on Magento\Robots\Model\Robots — theme-agnostic

Hyvä Checkout​

Hyvä Checkout is React-based and only renders the checkout flow, so the SEO Suite's storefront templates are not in scope there. The GraphQL seo: SeoMetadata field is still available if any of your checkout-time logic needs SEO metadata (rare).

What about a Hyvä admin theme?​

If you've installed a Hyvä admin theme, the SEO Suite's two pieces of admin JS — the Generate with AI button on product/category/CMS edit forms and the dashboard widget — both run cleanly because:

  • The "Generate with AI" UI component is a thin wrapper around Magento_Ui/js/form/components/html + Magento_Ui/js/modal/modal + jQuery, all of which Hyvä admin themes preserve
  • The dashboard widget is pure HTML + inline CSS, no JS at all

Verifying on a Hyvä storefront​

Same as Luma — visit any product page, view source, search for the four blocks. Nothing different to look for.

Composer suggest​

composer.json includes:

"suggest": {
  "hyva-themes/magento2-theme-module":
    "Hyvä theme consumes the same head.additional blocks — no extra module required."
}

This is purely informational; nothing else needs to be installed.

Next​

  • VelaFront — for fully headless storefronts (Hyvä Checkout / Next.js / PWA Studio)