Shopify metaobject SEO
and structured data

What are Shopify metaobjects?

Metaobjects are merchant-defined structured objects inside your Shopify store — like custom database tables where you define the schema (definition) and fill in the rows (entries). Each definition has a type (e.g. faq_item, store_location, ingredient) and a set of typed fields.

Unlike metafields, which attach additional data to existing Shopify objects (products, variants, collections), metaobjects are standalone entities. You can link them to products via a metafield of type metaobject_reference or list.metaobject_reference, making them reusable across multiple products or pages.

Metaobject vs. metafield — which to use for structured data?

Schema.org types that map naturally to metaobjects

FAQPage schema from metaobjects (complete example)

This is the most common and highest-impact metaobject structured data pattern. FAQ Rich Results appear in Google Search and in Google AI Mode summaries. Each question-answer pair you add in Shopify Admin automatically appears in structured data.

Step 1: Create the metaobject definition

In Shopify Admin → Content → Metaobjects → Add definition:

• Type: faq_item
• Field 1: Key question, Type: Single line text
• Field 2: Key answer, Type: Multi-line text (or Rich text)
• Check "Has web presence" if you want /faq URLs to be accessible

Step 2: Create a metafield on products/pages to link FAQ entries

In Shopify Admin → Settings → Custom data → Products → Add definition:

• Name: FAQ items
• Namespace and key: custom.faq_items
• Type: List of metaobjects (select faq_item as the referenced type)

Step 3: Liquid JSON-LD output

{% assign faq_items = product.metafields.custom.faq_items.value %}
{% if faq_items.size > 0 %}
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {% for item in faq_items %}
    {
      "@type": "Question",
      "name": {{ item.question.value | json }},
      "acceptedAnswer": {
        "@type": "Answer",
        "text": {{ item.answer.value | strip_html | json }}
      }
    }{% unless forloop.last %},{% endunless %}
    {% endfor %}
  ]
}
</script>
{% endif %}

LocalBusiness schema from a store_location metaobject

For Shopify stores with physical retail locations, a store_location metaobject lets store managers update hours, address, and phone numbers in Admin without touching Liquid code — and every change automatically flows into the JSON-LD for Google AI Mode's local shopping results.

Metaobject definition fields

Liquid JSON-LD output for a location page

{% assign loc = metaobject %}
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Store",
  "name": {{ loc.name.value | json }},
  "url": "{{ shop.url }}/locations/{{ loc.handle }}",
  "telephone": {{ loc.phone.value | json }},
  "address": {
    "@type": "PostalAddress",
    "streetAddress": {{ loc.street_address.value | json }},
    "addressLocality": {{ loc.city.value | json }},
    "addressRegion": {{ loc.state.value | json }},
    "postalCode": {{ loc.zip.value | json }},
    "addressCountry": {{ loc.country.value | json }}
  },
  "geo": {
    "@type": "GeoCoordinates",
    "latitude": {{ loc.latitude.value | json }},
    "longitude": {{ loc.longitude.value | json }}
  },
  "openingHoursSpecification": [
    {% assign days = "Monday,Tuesday,Wednesday,Thursday,Friday,Saturday,Sunday" | split: "," %}
    {% assign keys = "monday_hours,tuesday_hours,wednesday_hours,thursday_hours,friday_hours,saturday_hours,sunday_hours" | split: "," %}
    {% for day in days %}
    {% assign key = keys[forloop.index0] %}
    {% assign hours = loc[key].value %}
    {% if hours != blank and hours != "Closed" %}
    {
      "@type": "OpeningHoursSpecification",
      "dayOfWeek": "https://schema.org/{{ day }}",
      "opens": "{{ hours | split: '-' | first | strip }}",
      "closes": "{{ hours | split: '-' | last | strip }}"
    }{% unless forloop.last %},{% endunless %}
    {% endif %}
    {% endfor %}
  ],
  "parentOrganization": {
    "@type": "Organization",
    "name": {{ shop.name | json }},
    "url": {{ shop.url | json }}
  }
}
</script>

Product specification tables via metaobjects

Technical products (electronics, hardware, apparel with materials) benefit significantly from structured additionalProperty values in their JSON-LD. AI shopping agents use these to answer specification queries: "which headphones have 40-hour battery life", "shoes made from recycled materials", "monitors with 4K resolution under $400".

Instead of hardcoding spec values into metafields per product (which requires creating dozens of individual metafields), a specification metaobject lets you create reusable spec entry objects and attach a list of them to each product.

Specification → additionalProperty output

{% assign specs = product.metafields.custom.specifications.value %}
{% if specs.size > 0 %}
  "additionalProperty": [
    {% for spec in specs %}
    {
      "@type": "PropertyValue",
      "name": {{ spec.spec_name.value | json }},
      "value": {{ spec.spec_value.value | json }}
      {% if spec.unit.value != blank %}
      ,"unitCode": {{ spec.unit.value | json }}
      {% endif %}
    }{% unless forloop.last %},{% endunless %}
    {% endfor %}
  ]
{% endif %}

Metaobject URL pages and canonical tags

When you enable "Has web presence" for a metaobject definition, Shopify creates accessible URLs for each entry based on the URL template you define (e.g., /locations/{handle}). These pages are crawled and indexed by default. There are two SEO considerations:

1. Canonical tags — Shopify automatically adds a <link rel="canonical"> tag with the metaobject entry's URL. Verify it is correct with curl -s URL | grep canonical. If your metaobject pages have duplicate content (e.g., multiple location entries sharing similar descriptions), add noindex to low-value entries or ensure each entry has unique content in at least one field.
2. Sitemap inclusion — Metaobject pages are included in Shopify's auto-generated /sitemap.xml as of Shopify platform version 2024-01. If you want to suppress them (e.g., for internal-only metaobjects), set the entry to "Not available online" in the metaobject definition settings.

Scan for structured data completeness

CatalogScan checks whether your Shopify store's product pages include FAQPage, additionalProperty specification values, and other rich schema types — including data sourced from metaobjects. Get a full report of which structured data your AI shopping agents can read.

Scan your store free

Related: Shopify metafields and AI agents · Metafields guide (blog) · Schema markup overview