Shopify Smart Home & IoT Device Schema — Matter, Zigbee, Z-Wave Protocol Compatibility & Ecosystem Hub Structured Data

Why Smart Home Devices Are Invisible to AI Agent Queries

The smart home device market is segmented by protocol compatibility in ways that directly drive purchase decisions. A shopper building a Zigbee mesh cannot use a Z-Wave device. A buyer who already owns a Philips Hue Bridge wants Zigbee-compatible sensors — not WiFi sensors that require their own app. A HomeKit household needs Thread or Matter, not Zigbee. These protocol and ecosystem constraints are the primary filter in smart home purchase queries.

Shopify's default product JSON-LD outputs name, description, offers, and image. None of these carry wireless protocol, hub requirement, Z-Wave region (US vs EU), Matter version, or ecosystem compatibility. An AI agent answering "Zigbee motion sensor compatible with Home Assistant under $30" has no structured data to filter against — the protocol and compatibility information exists only in unstructured description text, which AI agents cannot reliably parse for attribute matching at scale.

Query types requiring smart home structured data

Section 1: Matter-Enabled Smart Plug — No Hub Required

Matter 1.2 is the universal smart home standard from the Connectivity Standards Alliance (CSA). A Matter device works with every Matter-certified ecosystem — Apple HomeKit, Google Home, Amazon Alexa, Samsung SmartThings, and Home Assistant — without proprietary bridges or hubs. The schema must express the Matter version, the transport (WiFi or Thread), and explicitly state that no hub is required. This is the decisive signal for AI agents filtering out hub-dependent devices.

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "SmartHome Matter Smart Plug 15A with Energy Monitoring",
  "sku": "SHSP-MATTER-15A",
  "description": "Matter 1.2 certified smart plug with 15A capacity and real-time energy monitoring. Works with Apple HomeKit, Google Home, Amazon Alexa, Samsung SmartThings, and Home Assistant — no proprietary hub required. Supports WiFi and Thread networks.",
  "brand": {
    "@type": "Brand",
    "name": "SmartHome"
  },
  "offers": {
    "@type": "Offer",
    "price": "34.99",
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock",
    "itemCondition": "https://schema.org/NewCondition"
  },
  "additionalProperty": [
    {
      "@type": "PropertyValue",
      "name": "Device Type",
      "value": "Smart Plug / Outlet"
    },
    {
      "@type": "PropertyValue",
      "name": "Wireless Protocol",
      "value": "Matter 1.2 over WiFi and Thread",
      "description": "Matter 1.2 — CSA (Connectivity Standards Alliance) universal smart home standard. Works over WiFi (802.11 b/g/n 2.4GHz) or Thread network. No proprietary hub required — works with all Matter-certified ecosystems."
    },
    {
      "@type": "PropertyValue",
      "name": "Hub Required",
      "value": "No hub required",
      "description": "Works standalone via WiFi. Optional Thread border router (Apple HomePod mini, Google Nest Hub 2nd gen, Amazon Echo 4th gen) enables Thread mesh networking for lower latency."
    },
    {
      "@type": "PropertyValue",
      "name": "Supported Ecosystems",
      "value": "Apple HomeKit, Google Home, Amazon Alexa, Samsung SmartThings, Home Assistant — all via Matter"
    },
    {
      "@type": "PropertyValue",
      "name": "WiFi Standard",
      "value": "802.11 b/g/n — 2.4GHz only",
      "description": "2.4GHz only — does not support 5GHz. Ensure router 2.4GHz band is enabled."
    },
    {
      "@type": "PropertyValue",
      "name": "Bluetooth",
      "value": "Bluetooth 5.0 — commissioning only",
      "description": "BLE 5.0 used only for initial setup/commissioning. Not used for ongoing control."
    },
    {
      "@type": "PropertyValue",
      "name": "Max Load",
      "value": "15",
      "unitCode": "AMP",
      "description": "15A / 1800W max resistive load. Not rated for motor loads above 50% of max."
    },
    {
      "@type": "PropertyValue",
      "name": "Standby Power",
      "value": "0.5",
      "unitCode": "W",
      "description": "0.5W standby power draw when idle"
    },
    {
      "@type": "PropertyValue",
      "name": "Energy Monitoring",
      "value": "Yes — real-time wattage, kWh cumulative, voltage, amperage via Matter Energy cluster"
    },
    {
      "@type": "PropertyValue",
      "name": "Power Source",
      "value": "Mains 120V AC — US plug NEMA 5-15"
    },
    {
      "@type": "PropertyValue",
      "name": "Dimensions",
      "value": "52 × 38 × 38 mm"
    },
    {
      "@type": "PropertyValue",
      "name": "FCC ID",
      "value": "2AFZZ-SPMAT12"
    }
  ],
  "hasCertification": [
    {
      "@type": "Certification",
      "name": "FCC Part 15",
      "certificationIdentification": "2AFZZ-SPMAT12",
      "issuedBy": {
        "@type": "Organization",
        "name": "Federal Communications Commission",
        "url": "https://fcc.gov"
      }
    },
    {
      "@type": "Certification",
      "name": "UL 498",
      "issuedBy": {
        "@type": "Organization",
        "name": "UL (Underwriters Laboratories)"
      }
    },
    {
      "@type": "Certification",
      "name": "Matter Certification",
      "issuedBy": {
        "@type": "Organization",
        "name": "Connectivity Standards Alliance (CSA)",
        "url": "https://csa-iot.org"
      }
    },
    {
      "@type": "Certification",
      "name": "CE Marking"
    },
    {
      "@type": "Certification",
      "name": "RoHS Compliance"
    },
    {
      "@type": "Certification",
      "name": "Energy Star"
    }
  ],
  "compatibleWith": [
    {
      "@type": "Product",
      "name": "Apple HomeKit",
      "description": "via Matter",
      "url": "https://www.apple.com/home-app/"
    },
    {
      "@type": "Product",
      "name": "Google Home",
      "description": "via Matter",
      "url": "https://home.google.com"
    },
    {
      "@type": "Product",
      "name": "Amazon Alexa",
      "description": "via Matter",
      "url": "https://www.amazon.com/alexa"
    },
    {
      "@type": "Product",
      "name": "Samsung SmartThings",
      "description": "via Matter",
      "url": "https://www.smartthings.com"
    },
    {
      "@type": "Product",
      "name": "Home Assistant",
      "description": "via Matter",
      "url": "https://www.home-assistant.io"
    }
  ]
}

The Hub Required: No hub required PropertyValue is the signal AI agents use when a buyer filters for "no hub" or "hub-free" smart home devices. The compatibleWith array makes ecosystem compatibility explicit and machine-readable — AI agents do not need to parse "Works with Alexa" from description text. The FCC ID in both additionalProperty and hasCertification.certificationIdentification enables FCC lookup verification and acts as a certification trust signal.

Section 2: Zigbee Motion Sensor — Hub Required, Multi-Ecosystem

Zigbee 3.0 devices require a Zigbee-compatible hub or coordinator. The hub requirement must be stated explicitly — and the compatible hub models must be enumerated in the description. This is critical because Zigbee compatibility varies by hub: a Zigbee device that works with SmartThings may not be natively supported by Philips Hue Bridge (which only recognizes Hue-certified Zigbee devices). AI agents need this nuance to prevent recommending a Zigbee sensor to a buyer whose only hub is a Philips Hue Bridge.

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "ProSense Zigbee 3.0 PIR Motion Sensor with Lux Detection",
  "sku": "PS-ZB-MOT-PIR",
  "description": "Zigbee 3.0 battery-powered PIR motion sensor with configurable sensitivity and lux threshold. Hub required. Compatible with SmartThings, Home Assistant (Zigbee USB coordinator), Amazon Echo 4th gen built-in Zigbee, and Aeotec Smart Home Hub.",
  "brand": {
    "@type": "Brand",
    "name": "ProSense"
  },
  "offers": {
    "@type": "Offer",
    "price": "27.99",
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock",
    "itemCondition": "https://schema.org/NewCondition"
  },
  "additionalProperty": [
    {
      "@type": "PropertyValue",
      "name": "Wireless Protocol",
      "value": "Zigbee 3.0",
      "description": "Zigbee 3.0 — IEEE 802.15.4 mesh protocol at 2.4GHz. Low power, mesh network topology — each Zigbee device extends the mesh. Hub required."
    },
    {
      "@type": "PropertyValue",
      "name": "Hub Required",
      "value": "Yes — Zigbee-compatible hub required",
      "description": "Compatible hubs: Philips Hue Bridge (limited — only Hue-certified Zigbee devices), IKEA Dirigera, SmartThings Hub v3+, Aeotec Smart Home Hub, Home Assistant with Zigbee USB coordinator (ConBee II, Sonoff Zigbee 3.0 USB Dongle Plus), Amazon Echo 4th gen (built-in Zigbee hub)."
    },
    {
      "@type": "PropertyValue",
      "name": "Zigbee Channel",
      "value": "Channels 11-26 — 2.4GHz",
      "description": "Zigbee operates in same 2.4GHz band as WiFi — channel overlap with WiFi channels 1, 6, 11 can cause interference. Recommended Zigbee channels: 15, 20, 25, 26."
    },
    {
      "@type": "PropertyValue",
      "name": "Device Type within Zigbee",
      "value": "End device — not router",
      "description": "Battery-powered sensors are Zigbee end devices — they do NOT route traffic. Zigbee routers (always-powered devices) extend mesh range."
    },
    {
      "@type": "PropertyValue",
      "name": "Motion Detection Technology",
      "value": "Passive Infrared (PIR)",
      "description": "PIR sensor detects infrared radiation change — warm bodies moving through field of view. Not microwave/radar — does not detect through walls."
    },
    {
      "@type": "PropertyValue",
      "name": "Detection Range",
      "value": "7",
      "unitCode": "MTR",
      "description": "7m (23 ft) detection radius"
    },
    {
      "@type": "PropertyValue",
      "name": "Detection Angle",
      "value": "120",
      "unitCode": "DD",
      "description": "120° horizontal detection arc — UN/CEFACT DD = degrees"
    },
    {
      "@type": "PropertyValue",
      "name": "Sensitivity Levels",
      "value": "3 — Low/Medium/High"
    },
    {
      "@type": "PropertyValue",
      "name": "Lux Threshold",
      "value": "Configurable — 0-1000 lux",
      "description": "Illuminance threshold for day/night mode switching — disable motion alerts when bright enough"
    },
    {
      "@type": "PropertyValue",
      "name": "Power Source",
      "value": "AAA × 2 battery — included"
    },
    {
      "@type": "PropertyValue",
      "name": "Battery Life",
      "value": "730",
      "unitCode": "DAY",
      "description": "~2 years on 2× AAA batteries at standard use (10 detections/day)"
    },
    {
      "@type": "PropertyValue",
      "name": "Tamper Alert",
      "value": "Yes — physical tamper detection switch"
    }
  ],
  "hasCertification": [
    {
      "@type": "Certification",
      "name": "Zigbee 3.0 Certification",
      "issuedBy": {
        "@type": "Organization",
        "name": "Connectivity Standards Alliance (CSA)",
        "url": "https://csa-iot.org"
      }
    },
    {
      "@type": "Certification",
      "name": "FCC Part 15",
      "issuedBy": {
        "@type": "Organization",
        "name": "Federal Communications Commission"
      }
    },
    {
      "@type": "Certification",
      "name": "CE Marking"
    },
    {
      "@type": "Certification",
      "name": "RoHS Compliance"
    }
  ],
  "compatibleWith": [
    {
      "@type": "Product",
      "name": "Samsung SmartThings"
    },
    {
      "@type": "Product",
      "name": "Home Assistant",
      "description": "via Zigbee USB coordinator (ConBee II, Sonoff Zigbee 3.0 USB Dongle Plus)"
    },
    {
      "@type": "Product",
      "name": "Amazon Echo (4th gen)",
      "description": "Built-in Zigbee hub — no separate hub required"
    },
    {
      "@type": "Product",
      "name": "Philips Hue Bridge",
      "description": "Limited compatibility — Philips Hue Bridge only supports Hue-certified Zigbee devices. This sensor is NOT Hue-certified and will not pair with Hue Bridge."
    }
  ]
}

Note the Philips Hue Bridge compatibleWith entry with an explicit incompatibility disclaimer. This is a critical schema pattern: a buyer who owns only a Hue Bridge searches for "Zigbee sensor Philips Hue compatible" — if your product is not Hue-certified, listing Hue Bridge without this disclaimer will generate returns. The description field on a compatibleWith entry is the correct place for this nuance.

The unitCode: "DD" on Detection Angle uses the UN/CEFACT common code for degrees, which is the correct machine-readable unit for angle values. MTR for meters on Detection Range follows the same UN/CEFACT standard — see our product specifications structured data guide for the full unit code reference.

Section 3: Z-Wave Plus V2 Smart Lock — S2 Security

Z-Wave operates at sub-GHz frequencies (908.42 MHz in the US, 868.42 MHz in EU) — entirely separate from the 2.4GHz band shared by WiFi, Zigbee, Bluetooth, and Thread. This eliminates 2.4GHz congestion for locks, which require high reliability. However, Z-Wave is region-specific: a US 908MHz device is physically incompatible with EU 868MHz regions. This region field is frequently absent from smart lock listings and is a source of international returns. The schema must include it explicitly.

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "SecureEntry Z-Wave Plus V2 Smart Deadbolt — S2 Authenticated",
  "sku": "SE-ZW700-DLK-S2",
  "description": "Z-Wave Plus V2 (700 series) motorized smart deadbolt with S2 Security Level 2 authentication. ANSI/BHMA Grade 1 certified. Hub required — compatible with SmartThings, Aeotec Smart Home Hub, HomeSeer, Hubitat Elevation, and Home Assistant with Z-Wave USB stick. US 908.42MHz region.",
  "brand": {
    "@type": "Brand",
    "name": "SecureEntry"
  },
  "offers": {
    "@type": "Offer",
    "price": "199.99",
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock",
    "itemCondition": "https://schema.org/NewCondition"
  },
  "additionalProperty": [
    {
      "@type": "PropertyValue",
      "name": "Protocol",
      "value": "Z-Wave Plus V2 (700 series)",
      "description": "Z-Wave Plus V2 on 700 series chip — 100m outdoor / 40m indoor mesh range. Z-Wave operates at 908.42MHz (US) / 868.42MHz (EU) — dedicated sub-GHz band avoids 2.4GHz WiFi/Zigbee congestion."
    },
    {
      "@type": "PropertyValue",
      "name": "Z-Wave Region",
      "value": "US — 908.42MHz",
      "description": "Z-Wave is region-specific — a US 908MHz device will NOT work in EU 868MHz regions. Verify region before purchase."
    },
    {
      "@type": "PropertyValue",
      "name": "Security Framework",
      "value": "S2 — Security Level 2",
      "description": "Z-Wave S2 security: AES-128 encrypted communication with ECDH key exchange during inclusion. S0 (legacy) and no-security modes also supported for older hubs."
    },
    {
      "@type": "PropertyValue",
      "name": "Hub Required",
      "value": "Yes — Z-Wave hub required",
      "description": "Compatible hubs: SmartThings Hub, Aeotec Smart Home Hub, HomeSeer, Hubitat Elevation, Home Assistant with Z-Wave USB stick (Zooz ZST10, Aeotec Z-Stick 7)."
    },
    {
      "@type": "PropertyValue",
      "name": "Device Class",
      "value": "Z-Wave Door Lock — Generic Device Class 0x40",
      "description": "Z-Wave generic device class for door locks — enables proper command class discovery by any Z-Wave hub."
    },
    {
      "@type": "PropertyValue",
      "name": "Lock Type",
      "value": "Motorized deadbolt — Schlage B60N compatible"
    },
    {
      "@type": "PropertyValue",
      "name": "Entry Methods",
      "value": "Keypad PIN, Z-Wave remote, auto-lock timer"
    },
    {
      "@type": "PropertyValue",
      "name": "Auto-Lock",
      "value": "Yes — configurable 30 seconds to 30 minutes"
    },
    {
      "@type": "PropertyValue",
      "name": "Power Source",
      "value": "4 × AA alkaline batteries"
    },
    {
      "@type": "PropertyValue",
      "name": "Battery Life",
      "value": "12",
      "unitCode": "MON",
      "description": "~12 months on 4 × AA batteries — low battery alert at 20% via Z-Wave battery report"
    },
    {
      "@type": "PropertyValue",
      "name": "ANSI/BHMA Grade",
      "value": "ANSI/BHMA Grade 1 — Highest residential security rating"
    }
  ],
  "hasCertification": [
    {
      "@type": "Certification",
      "name": "Z-Wave Plus V2 Certified",
      "issuedBy": {
        "@type": "Organization",
        "name": "Z-Wave Alliance / Silicon Labs"
      }
    },
    {
      "@type": "Certification",
      "name": "ANSI/BHMA Grade 1",
      "issuedBy": {
        "@type": "Organization",
        "name": "Builders Hardware Manufacturers Association (BHMA)"
      }
    },
    {
      "@type": "Certification",
      "name": "UL Listed"
    }
  ],
  "compatibleWith": [
    {
      "@type": "Product",
      "name": "Samsung SmartThings"
    },
    {
      "@type": "Product",
      "name": "Aeotec Smart Home Hub"
    },
    {
      "@type": "Product",
      "name": "Hubitat Elevation"
    },
    {
      "@type": "Product",
      "name": "Home Assistant",
      "description": "via Z-Wave USB stick (Zooz ZST10 or Aeotec Z-Stick 7)"
    },
    {
      "@type": "Product",
      "name": "HomeSeer"
    }
  ]
}

The Z-Wave 700 series chip specification matters to buyers who need long-range mesh and low power. Earlier Z-Wave 500 series devices have shorter range and lack S2 security — AI agents serving informed buyers filter on chip generation. Include it in the Protocol value string, not just the description. For more on region-specific product schema patterns, see our guide on geo-restricted and region-specific product schema.

Section 4: Protocol Comparison Reference Table

AI agents need protocol-level context to distinguish between technologies that all appear as "smart home" or "wireless" in product descriptions. The table below reflects the data that should be encoded in your structured data — not just displayed in HTML.

Note that Matter (WiFi) and WiFi-only devices both use 2.4GHz and require no hub — but they are fundamentally different. Matter devices use the Matter protocol for local control and work across all Matter ecosystems. WiFi-only (non-Matter) devices typically use manufacturer cloud APIs and lose functionality if the cloud service is discontinued. AI agents should surface this distinction when answering reliability or local-control queries.

Section 5: Hub Compatibility Matrix

Hub compatibility determines which protocols a buyer can use without purchasing additional hardware. Many buyers already own a hub — they filter for devices compatible with their existing infrastructure. This matrix represents the data you must encode in compatibleWith arrays and hub-related additionalProperty descriptions.

SmartThings Z-Wave support requires Aeotec Smart Home Hub (a Z-Wave-certified hub that runs SmartThings firmware). Standalone SmartThings Hubs v3+ have built-in Zigbee and Z-Wave radios. Hubitat Matter support is via a Matter bridge — not native Matter controller. Home Assistant Matter support requires the Matter server integration and a Matter controller (typically a smartphone on the same network for commissioning).

Section 6: Liquid Implementation — smarthome.* Metafield Namespace

Store all smart home attributes in a smarthome metafield namespace on your Shopify products. This allows Liquid templates to inject the full structured data block with zero hardcoding and enables conditional logic for hub-free vs. hub-required devices and Z-Wave region warnings.

Metafield namespace — 14 fields

Liquid JSON-LD injection with conditional blocks

{% comment %}
  Smart Home / IoT Product — structured data injection
  Namespace: smarthome.*
  File: snippets/smarthome-schema.liquid
{% endcomment %}

{% assign sh = product.metafields.smarthome %}

{% if sh.wireless_protocol != blank %}
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": {{ product.title | json }},
  "sku": {{ product.selected_or_first_available_variant.sku | json }},
  "description": {{ product.description | strip_html | truncate: 400 | json }},
  "brand": {
    "@type": "Brand",
    "name": {{ product.vendor | json }}
  },
  "offers": {
    "@type": "Offer",
    "price": {{ product.selected_or_first_available_variant.price | divided_by: 100.0 | json }},
    "priceCurrency": {{ shop.currency | json }},
    "availability": {% if product.available %}"https://schema.org/InStock"{% else %}"https://schema.org/OutOfStock"{% endif %}
  },
  "additionalProperty": [
    {% if sh.device_type != blank %}
    {
      "@type": "PropertyValue",
      "name": "Device Type",
      "value": {{ sh.device_type | json }}
    },
    {% endif %}
    {
      "@type": "PropertyValue",
      "name": "Wireless Protocol",
      "value": {{ sh.wireless_protocol | json }}
    },
    {
      "@type": "PropertyValue",
      "name": "Hub Required",
      "value": {{ sh.hub_required | json }}
    },
    {% if sh.compatible_ecosystems != blank %}
    {
      "@type": "PropertyValue",
      "name": "Supported Ecosystems",
      "value": {{ sh.compatible_ecosystems | json }}
    },
    {% endif %}
    {% if sh.power_source != blank %}
    {
      "@type": "PropertyValue",
      "name": "Power Source",
      "value": {{ sh.power_source | json }}
    },
    {% endif %}
    {% if sh.max_load_amps != blank %}
    {
      "@type": "PropertyValue",
      "name": "Max Load",
      "value": {{ sh.max_load_amps | json }},
      "unitCode": "AMP"
    },
    {% endif %}
    {% if sh.fcc_id != blank %}
    {
      "@type": "PropertyValue",
      "name": "FCC ID",
      "value": {{ sh.fcc_id | json }}
    },
    {% endif %}
    {% if sh.zwave_region != blank %}
    {
      "@type": "PropertyValue",
      "name": "Z-Wave Region",
      "value": {{ sh.zwave_region | json }},
      "description": "Z-Wave is region-specific — a US 908MHz device will NOT work in EU 868MHz regions."
    },
    {% endif %}
    {% if sh.security_framework != blank %}
    {
      "@type": "PropertyValue",
      "name": "Security Framework",
      "value": {{ sh.security_framework | json }}
    },
    {% endif %}
    {
      "@type": "PropertyValue",
      "name": "Energy Monitoring",
      "value": {% if sh.energy_monitoring %}"Yes"{% else %}"No"{% endif %}
    }
  ]
  {% if sh.fcc_id != blank %},
  "hasCertification": [
    {
      "@type": "Certification",
      "name": "FCC Part 15",
      "certificationIdentification": {{ sh.fcc_id | json }}
    }
    {% if sh.matter_certified %},
    {
      "@type": "Certification",
      "name": "Matter Certification",
      "issuedBy": {
        "@type": "Organization",
        "name": "Connectivity Standards Alliance (CSA)"
      }
    }
    {% endif %}
  ]
  {% endif %}
}
</script>

{%- comment %} Hub-free callout — rendered in visible HTML for buyers {%- endcomment %}
{% if sh.hub_required == "No" %}
<div class="hub-free-badge">
  <strong>No hub required</strong> — connects directly via WiFi or Thread.
  Works with Alexa, Google Home, Apple HomeKit, SmartThings, and Home Assistant via Matter.
</div>
{% endif %}

{%- comment %} Z-Wave region warning — prevents international purchase errors {%- endcomment %}
{% if sh.wireless_protocol contains "Z-Wave" %}
<div class="zwave-region-warning">
  <strong>Z-Wave region notice:</strong>
  This device operates at {{ sh.zwave_region }}.
  Z-Wave devices are region-locked — a US 908MHz device cannot be used in EU 868MHz countries.
  If you are purchasing from outside the listed region, please contact us before ordering.
</div>
{% endif %}

{% endif %}

The conditional if sh.hub_required == "No" block renders a visible hub-free callout that reinforces the structured data signal for buyers scanning the page. The Z-Wave region warning block is injected only for Z-Wave devices and is critical for international storefronts. Both blocks serve dual purpose: visible reassurance for buyers and secondary signals that reinforce the structured data for crawlers that read page content alongside JSON-LD. See our electronics hardware schema guide for additional patterns for tech product metafields.

Section 7: Five Common Mistakes in Smart Home Product Schema

• Writing "Works with Alexa" without specifying protocol

  Matter, WiFi, and Zigbee devices all "work with Alexa" — but through fundamentally different mechanisms. A Matter device uses local control via Matter protocol. A WiFi device connects through Alexa cloud APIs and requires a persistent internet connection. A Zigbee device requires a Zigbee-capable Echo (4th gen only). AI agents handling "Alexa-compatible smart plug local control" cannot distinguish these unless the protocol is explicit in structured data. "Works with Alexa" as a string in additionalProperty is insufficient — the protocol must be declared separately.

• Missing hub requirement — the #1 return reason for smart home devices

  A buyer purchases a Zigbee door sensor without realizing they need a separate Zigbee hub ($60–$150). The product arrives, pairs with nothing, and is returned. The Hub Required field with a clear "Yes — Zigbee-compatible hub required" value and a list of compatible hubs in the description is the most commercially important attribute in smart home schema. AI shopping agents that surface this field pre-purchase prevent the return. Agents that cannot find it will complete the recommendation without it — and the merchant absorbs the return cost.

• Conflating "2.4GHz WiFi" and "2.4GHz Zigbee" — both 2.4GHz, completely incompatible

  Matter (Thread), Zigbee, WiFi, and Bluetooth all operate in the 2.4GHz band. Listing only "2.4GHz wireless" in a product description or as a structured data value is meaningless — it conveys no protocol information. AI agents filtering for "Zigbee sensor" cannot match a product that only declares "2.4GHz" in its data. Always use the protocol name (Zigbee 3.0, Matter 1.2, WiFi 802.11 b/g/n, Thread 1.3) as the primary value — never frequency band alone.

• Z-Wave region omission creates costly international returns

  Z-Wave devices operating at 908.42MHz (US) cannot be used in EU countries where Z-Wave operates at 868.42MHz — the radio frequency is hardcoded at the chip level. This is a physical incompatibility, not a software limitation. Without a Z-Wave Region PropertyValue, an EU buyer searching "Z-Wave Plus V2 smart lock" on a US Shopify store may purchase an incompatible device. Merchants selling internationally must declare Z-Wave Region: US — 908.42MHz and implement the Liquid-rendered region warning block. See our geo-restricted and region-specific product schema guide for the full areaServed and eligibleRegion pattern.

• Matter device class omission affects auto-discovery across ecosystems

  Matter distinguishes device types at the protocol level: lights, outlets, locks, sensors, thermostats, blinds, and more each have a Matter device type ID. These device types determine which ecosystems auto-discover the device and which capabilities (on/off, dimming, lock/unlock, temperature) are exposed. A Matter outlet (device type 0x010A) will appear in Alexa's "Outlet" category — not "Light." Declaring the Device Type PropertyValue (e.g., "Smart Plug / Outlet") in structured data enables AI agents to filter by device function, not just by protocol. Without it, a Matter-certified outlet and a Matter-certified bulb are structurally indistinguishable in the schema.