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
| Area | What you get |
|---|---|
| Meta | Title/description template engine with variables, global title suffix, native overrides always win |
| Structured data | JSON-LD providers for Product (offers, availability, brand, GTIN/MPN, aggregateRating), Breadcrumb, Organization, WebSite + SearchAction. Pluggable via ProviderInterface |
| Open Graph | og:* and twitter:* tags driven by the same template engine, with image fallback |
| Hreflang | Per-website tags with x-default + region codes, plus a CLI/admin validator and auto-matcher across stores |
| Canonicals | CMS-page canonical, manual byte8_seosuite_url mappings, plus a per-row Apply-Fix flow on detected issues |
| Robots.txt | Per-store rules editor (Magento core only supports website scope) — append or replace mode |
| Layered nav SEO | noindex,follow injected on filtered category URLs (two modes: noindex any, or noindex unlisted attributes only) |
| Out-of-stock rules | Tracks days-OOS per product per store; after threshold applies noindex / 301 / disable; manual override per row |
| Index Budget Audit | Five 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 Generator | Claude-powered bulk generator (CLI + cron + in-context button) with a review queue and per-store config |
| Dashboard widget | Single SEO health summary on the Magento admin home — colour-coded cards linking to each grid |
| GraphQL | seo: 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
| Platform | Status |
|---|---|
| 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
- Quick start — install, enable, and run your first AI generation in under five minutes
- Installation — composer requirements, setup commands, post-install checks
- Front-end → VelaFront — the GraphQL story
- AI Meta Generator → Overview — the most-asked-about feature