Skip to main content

Quick start

Five minutes from composer require to a working install with meta templates, JSON-LD, and a one-shot AI suggestion in your review queue.

1. Install​

composer require byte8io/magento-seosuite
bin/magento module:enable Byte8_SeoSuite
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

Full requirements + caveats are in Installation.

2. Verify the module loaded​

bin/magento module:status Byte8_SeoSuite
# Module is enabled

You should also see new menu entries under Marketing → SEO Suite:

  • Manage URL Relationship
  • AI Meta Suggestions
  • Hreflang Health
  • Index Budget Audit
  • Out-of-Stock Tracking
  • Redirects
  • 404 Log
  • 404 Auto-Heal Suggestions
  • GSC Performance

…and a new config section under Stores → Configuration → SEO Suite (visible at Default Config, Website, and Store View scopes).

3. Turn on the basics​

Defaults are deliberately conservative — nothing fires until you flip its switch. Three settings give you immediate value:

a) Meta title/description templates​

Stores → Configuration → SEO Suite → Meta Title & Description Templates

  • Enable templates = Yes
  • The default product title {{product.name}} and global suffix | {{store.frontend_name}} are usually what you want — adjust if needed

Native overrides (per-product meta_title, per-category meta_description) always win, so this won't disturb anything you've already set.

b) Structured data (JSON-LD)​

Stores → Configuration → SEO Suite → Structured Data

  • Enable JSON-LD output = Yes
  • Leave Product / Breadcrumb / Organization / WebSite all on (defaults to Yes)
  • Fill in Organization name + logo URL if you want the home-page Organization schema

Visit any product page → View source → search for application/ld+json. You should see one or two valid JSON-LD blocks.

c) Open Graph + Twitter​

Stores → Configuration → SEO Suite → Open Graph & Twitter Cards

  • Enable social meta tags = Yes
  • Optionally set a default share image URL

Test with Facebook Sharing Debugger or Twitter Card Validator.

4. (Optional) Try the AI Meta Generator​

Skip this if you don't want to plug an Anthropic API key in yet. Otherwise:

Stores → Configuration → SEO Suite → AI Meta Generator

  • Enable AI generation = Yes
  • Anthropic API key — paste yours from console.anthropic.com
  • Model — Claude Haiku 4.5 is the cheapest and fast enough for meta copy
  • Leave Auto-approve = No so suggestions land in the review queue first

Then run a one-shot generation against a few SKUs:

bin/magento seosuite:meta:generate -e product -i 12,34,56 -s 1

Open Marketing → SEO Suite → AI Meta Suggestions and you'll see three rows in the queue with model, token usage, and the generated title/description. Click Approve & Apply on each one to write them to the products.

You can also click the Generate with AI button on any product / category / CMS edit form for a single-entity preview without queueing — full walkthrough in In-context button.

5. (Optional) Run the audits​

bin/magento seosuite:hreflang:validate
bin/magento seosuite:index:audit

Each writes its findings to a persisted table; results show up in the Hreflang Health and Index Budget Audit grids.

If you want them to run automatically:

Stores → Configuration → SEO Suite → Admin Dashboard

  • Enable nightly Index Budget audit (cron) = Yes
  • Enable nightly Hreflang scan (cron) = Yes

What's next​