Skip to main content

Byte8 SEO Suite

A complete on-page SEO toolkit for Magento 2 — built headless-first, AI-native, and Hyvä-compatible out of the box.

The module covers the SEO surface Magento core leaves out: meta title/description templates, JSON-LD structured data, hreflang validation, layered-nav controls, an out-of-stock rules engine, an AI-powered meta generator, and a series of admin grids that audit and one-click-fix the most common Magento SEO bleeds. Every feature is also exposed via GraphQL so headless storefronts (VelaFront, PWA Studio, Hyvä Checkout) consume the same data the Luma storefront sees.

Who this is for

  • Magento agencies that want one suite covering the full SEO surface — instead of stitching together Mageworx, Amasty, and a custom canonical/redirects module per client
  • Headless / VelaFront / PWA Studio projects that need every SEO artifact (meta, robots, canonical, OG, JSON-LD) returned by GraphQL rather than scraped from the rendered page
  • Multi-store / international merchants with hreflang setups that need real validation rather than blind tag emission
  • Catalog teams managing 1k+ SKUs who can't hand-write meta titles and descriptions — the AI Meta Generator drafts them with prompt caching, then surfaces them in a review queue

What ships in v2.x

AreaWhat you get
MetaTitle/description template engine with variables, global title suffix, native overrides always win
Structured dataJSON-LD providers for Product (offers, availability, brand, GTIN/MPN, aggregateRating), Breadcrumb, Organization, WebSite + SearchAction. Pluggable via ProviderInterface
Open Graphog:* and twitter:* tags driven by the same template engine, with image fallback
HreflangPer-website tags with x-default + region codes, plus a CLI/admin validator and auto-matcher across stores
CanonicalsCMS-page canonical, manual byte8_seosuite_url mappings, plus a per-row Apply-Fix flow on detected issues
Robots.txtPer-store rules editor (Magento core only supports website scope) — append or replace mode
Layered nav SEOnoindex,follow injected on filtered category URLs (two modes: noindex any, or noindex unlisted attributes only)
Out-of-stock rulesTracks days-OOS per product per store; after threshold applies noindex / 301 / disable; manual override per row
Index Budget AuditFive auditors covering OOS-but-indexable, disabled-with-rewrites, layered-nav explosion, canonical config, CMS missing meta — with auto-fixers for the deterministic codes
AI Meta GeneratorClaude-powered bulk generator (CLI + cron + in-context button) with a review queue and per-store config
Dashboard widgetSingle SEO health summary on the Magento admin home — colour-coded cards linking to each grid
GraphQLseo: SeoMetadata field on ProductInterface, CategoryInterface, CmsPage, CmsPageItem

What this docs site covers

  • Getting started — install, first-run quick-start, upgrade from 1.x
  • Front-end — Luma, Hyvä, and VelaFront integration patterns
  • One section per feature — every config flag, CLI option, and extension point documented
  • Reference — exhaustive tables for CLI commands, cron jobs, system config paths, and ACL resources

What's not included (yet)

The roadmap from v2.9 onwards: HTML sitemap, image/video XML sitemaps, pagination SEO controls, redirects manager v2 (CSV import + 404 capture), 404 auto-healer, visual Schema Composer, GSC integration, AI image alt-text. Track progress in the changelog.

Compatibility

PlatformStatus
Magento Open Source ≥ 2.4.0
Adobe Commerce (EE / ECE) ≥ 2.4.0
PHP 8.2 / 8.3 / 8.4 / 8.5
Luma theme
Hyvä theme✅ (no Knockout / RequireJS dependencies in any template)
Headless (VelaFront, PWA Studio, Hyvä Checkout)✅ via GraphQL

Next steps