How to fix missing schema webpage on Adobe Commerce (Magento)

Add WebPage schema markup to every page so search engines and AI answer engines can precisely understand and describe your content.

Steps for Adobe Commerce (Magento)

  1. The cleanest approach is to create or edit a layout XML file for the relevant page type, e.g., cms_index_index.xml for the homepage, in your custom theme under app/design/frontend/<Vendor>/<theme>/Magento_Cms/layout/.
  2. Add a block of type 'Magento\Framework\View\Element\Template' referencing a .phtml template file that outputs your JSON-LD <script> block, and set the block's container to 'head.additional'.
  3. In the .phtml template, use Magento's escaping helpers and store/page data to dynamically populate name, description, and url fields.
  4. Alternatively, install a structured data extension from the Magento Marketplace (e.g., 'Schema.org Structured Data' by various vendors) which handles WebPage and other schema types automatically across all page types.
  5. After deploying (and flushing the full-page cache: System → Cache Management → Flush Magento Cache), validate with the Rich Results Test.
Official Adobe Commerce (Magento) documentation ↗

What is missing schema webpage?

Schema markup is a small block of invisible, structured code you add to a web page that tells search engines and AI systems exactly what the page is — its title, description, URL, and type. The `WebPage` schema type is the foundational label that says "this is a web page, here is its name, here is what it's about." Without it, search engines and AI tools have to guess this information by reading your page like a human would, which is less reliable. Think of it like a name tag for your page that any machine can instantly read.

Adding `WebPage` schema directly supports Answer Engine Optimization (AEO) — the emerging discipline of making your content eligible to be quoted or cited by AI assistants like Google's AI Overviews, ChatGPT, and Bing Copilot. AI systems rely heavily on structured data to identify authoritative, trustworthy sources to pull answers from; a missing `WebPage` schema means your pages are less likely to be chosen. It also strengthens your baseline for rich results eligibility and helps Google correctly index and understand every page on your site, which supports rankings and organic traffic. For ecommerce stores in particular, this can mean more product pages, category pages, and content pages surfacing in both traditional search results and AI-generated answers.

See the complete Missing schema webpage guide for every platform and the full background.

Not sure if your Adobe Commerce (Magento) store has this?

Run a free SEOLZ scan — we’ll find missing schema webpage and every other issue across your whole site.

Scan my site free

Fix missing schema webpage on another platform