Optimization Guide
Shopify Home Lighting Schema — Lumens, Color Temperature, CRI, Bulb Base Type, ENERGY STAR & Smart Bulb Protocol Structured Data
AI shopping agents handling queries like "800 lumen warm white E26 dimmable LED bulb," "Matter smart bulb compatible with Apple HomeKit no hub required," "CRI 90+ retail display lighting," or "IP65 outdoor PAR38 5000K floodlight" need machine-readable lumens, color temperature, CRI, base type, and wireless protocol data. Shopify's default JSON-LD for a light bulb outputs name and price only — the absence of lumens, CCT, base type, and smart protocol compatibility makes every spec-filtered or ecosystem-filtered lighting query unmatched.
Product @type with additionalProperty for Lumens (LUM), Wattage (W), Color Temperature/CCT (KEL), CRI (plain number, no unitCode), Bulb Base Type, Dimmable (boolean), Color Capability, Wireless Protocol, IP Rating, and Lifespan (HUR). Add hasCertification for ENERGY STAR, UL 1598, ETL, FCC Part 15, and DLC. Use compatibleWith on smart bulbs for Matter/Zigbee/WiFi ecosystem platforms. Store all values in a lighting.* metafield namespace.
Why Lumens Beat Watts for AI Query Matching
The single most damaging data gap in lighting product pages is listing watts but not lumens. Watts measure energy consumption — how much electricity the bulb draws. Lumens measure light output — how bright the bulb actually is. A 9-watt LED produces 800 lumens, the same brightness as a 60-watt incandescent. A shopper who searches "800 lumen bulb" or "equivalent to 60W" is expressing a brightness need, not an energy consumption preference.
AI shopping agents performing spec-filtered matching on brightness queries require a numeric lumens value with the correct unit code. When a product page publishes only wattage, the agent cannot resolve "how bright is this bulb?" from structured data alone and must either skip the product or attempt unreliable natural language extraction from the description. Including both lumens (UN/CEFACT unitCode LUM) and watts (unitCode W) in separate additionalProperty entries, plus a Replacement Equivalent Watts property, covers all three query patterns: lumen-based, watt-based, and incandescent-equivalent.
Lumens per Watt: LED Efficacy Context
LED efficacy has improved dramatically. A reference point for structured data descriptions: standard residential LEDs deliver 80–100 lumens per watt; premium LEDs reach 120–140 lm/W; commercial high-bay LEDs can exceed 160 lm/W. Incandescent bulbs produce approximately 13–15 lm/W. Include efficacy in the description field so AI agents can resolve "most efficient LED bulb" queries: "description": "800 lumens at 9W — 89 lm/W efficacy. Replaces 60W incandescent (13 lm/W)."
Smart Bulb Schema — Philips Hue A19 E26 Matter Example
The smart bulb example covers the complete spec set: lumens, CCT range, CRI, base type, dimmable, color capability, wireless protocol, smart ecosystem compatibility, ENERGY STAR, FCC Part 15, and lifespan. This is the reference schema for any WiFi, Zigbee, or Matter smart bulb product page.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Philips Hue White and Color Ambiance A19 E26 Smart Bulb — Matter 1.2, 800 Lumens, 2000K-6500K Full Color",
"description": "Philips Hue White and Color Ambiance A19 LED smart bulb with E26 medium screw base. 800 lumens. Full color RGB+W: 16 million colors plus tunable white 2000K–6500K. Matter 1.2 certified — works with Apple HomeKit, Google Home, Amazon Alexa, and Samsung SmartThings. Also controllable via Philips Hue Bridge (Zigbee). Dimmable. CRI 80+. 25,000-hour rated life. ENERGY STAR certified.",
"sku": "HUE-A19-E26-COLOR-MATTER",
"mpn": "929002489801",
"brand": { "@type": "Brand", "name": "Philips Hue" },
"hasCertification": [
{
"@type": "Certification",
"name": "ENERGY STAR Certified",
"issuedBy": {
"@type": "Organization",
"name": "U.S. Environmental Protection Agency (EPA)",
"url": "https://www.energystar.gov"
},
"certificationIdentification": "ENERGY STAR Registration — verify at energystar.gov/productfinder/product/etpmatch/details/LEDBulbs",
"description": "ENERGY STAR certified LED bulb. Meets EPA minimum efficacy, lifespan, CRI, and lumen maintenance (L70) standards. FTC Lighting Facts label compliant."
},
{
"@type": "Certification",
"name": "FCC Part 15 — Class B",
"issuedBy": {
"@type": "Organization",
"name": "Federal Communications Commission (FCC)",
"url": "https://www.fcc.gov"
},
"description": "FCC Part 15 Class B — required for all wireless consumer devices sold in the US. Verifies the smart bulb's Matter/WiFi/Zigbee radio does not cause harmful interference to other devices."
},
{
"@type": "Certification",
"name": "UL Listed — UL 8750",
"issuedBy": {
"@type": "Organization",
"name": "UL (Underwriters Laboratories)",
"url": "https://www.ul.com"
},
"certificationIdentification": "UL 8750",
"description": "UL 8750 — Light Emitting Diode (LED) Equipment for Use in Lighting Products. UL Listed for US and Canada."
}
],
"compatibleWith": [
{
"@type": "Product",
"name": "Apple HomeKit",
"brand": { "@type": "Brand", "name": "Apple" },
"description": "Works with Apple HomeKit via Matter 1.2 over Thread or WiFi. Requires a Thread Border Router (Apple HomePod mini, Apple HomePod 2nd gen, or Apple TV 4K 3rd gen) for Thread operation."
},
{
"@type": "Product",
"name": "Google Home",
"brand": { "@type": "Brand", "name": "Google" },
"description": "Works with Google Home via Matter 1.2. Google Nest Hub (2nd gen), Google Nest WiFi Pro, and Nest Hub Max function as Thread Border Routers."
},
{
"@type": "Product",
"name": "Amazon Alexa",
"brand": { "@type": "Brand", "name": "Amazon" },
"description": "Works with Amazon Alexa via Matter 1.2. Amazon Echo (4th gen) includes a built-in Zigbee hub and Thread Border Router."
},
{
"@type": "Product",
"name": "Samsung SmartThings",
"brand": { "@type": "Brand", "name": "Samsung" },
"description": "Works with Samsung SmartThings via Matter 1.2 and natively via Zigbee with Philips Hue Bridge."
},
{
"@type": "Product",
"name": "Philips Hue Bridge",
"brand": { "@type": "Brand", "name": "Philips Hue" },
"description": "Also controllable via Philips Hue Bridge (Zigbee 3.0). Hue Bridge required for Hue app scenes, routines, and entertainment sync features. Bridge sold separately."
}
],
"additionalProperty": [
{ "@type": "PropertyValue", "name": "Bulb Type", "value": "LED Smart Bulb" },
{ "@type": "PropertyValue", "name": "Bulb Shape", "value": "A19", "description": "A19 standard general-purpose bulb shape. 60mm diameter body." },
{ "@type": "PropertyValue", "name": "Bulb Base Type", "value": "E26", "description": "E26 medium screw base — US standard 26mm diameter Edison screw. Fits standard US lamp sockets, floor lamps, table lamps, pendant fixtures, and ceiling fan light kits." },
{ "@type": "PropertyValue", "name": "Lumens", "value": "800", "unitCode": "LUM", "description": "800 lumens maximum light output at full brightness and color temperature 2700K. Equivalent brightness to a 60-watt incandescent bulb. Output may vary slightly at other color temperatures." },
{ "@type": "PropertyValue", "name": "Wattage", "value": "10", "unitCode": "W", "description": "10 watts actual energy consumption at full brightness — LED efficiency vs 60W incandescent replacement." },
{ "@type": "PropertyValue", "name": "Replacement Equivalent Watts", "value": "60", "unitCode": "W", "description": "Replaces a 60-watt incandescent bulb. Based on lumen equivalency (800 lm)." },
{ "@type": "PropertyValue", "name": "Color Temperature Range (CCT)", "value": "2000-6500", "unitCode": "KEL", "description": "Tunable white range: 2000K (ultra-warm candlelight) to 6500K (daylight blue). Includes full RGB color capability. 2700K warm white mode for living room ambiance; 4000K cool white for kitchen task lighting; 6500K daylight for reading and focus." },
{ "@type": "PropertyValue", "name": "CRI (Color Rendering Index)", "value": "80", "description": "CRI 80+ — standard residential color rendering. Objects appear natural under this light. For retail display or color-critical applications, upgrade to CRI 90+ fixtures." },
{ "@type": "PropertyValue", "name": "Color Capability", "value": "Full Color RGB+W", "description": "Full Color RGB+W — produces 16 million colors via RGB channels plus tunable white (2000K–6500K). Can display any hue including reds, greens, blues, purples. White channel is independent of RGB for clean white light." },
{ "@type": "PropertyValue", "name": "Dimmable", "value": "true", "description": "Fully dimmable 1%–100% via app, voice control, or compatible smart dimmer. No flicker or buzz at any dim level. For physical dimmer switch control, use a certified Philips Hue dimmer switch or compatible smart dimmer (see compatibleDimmerType)." },
{ "@type": "PropertyValue", "name": "Compatible Dimmer Type", "value": "Smart Dimmer (Philips Hue / Matter certified)", "description": "Designed for app and voice dimming via Matter. For wall dimmer use, requires a smart dimmer compatible with Matter smart bulbs. Not designed for use with standard leading-edge or trailing-edge TRIAC dimmers — may cause flicker or buzzing on conventional dimmer circuits." },
{ "@type": "PropertyValue", "name": "Wireless Protocol", "value": "Matter 1.2", "description": "Matter 1.2 certified (Thread + WiFi). Works with Apple HomeKit, Google Home, Amazon Alexa, Samsung SmartThings without proprietary cloud lock-in. Thread provides low-latency mesh networking. WiFi mode for direct connection without Thread Border Router." },
{ "@type": "PropertyValue", "name": "Hub Requirement", "value": "No hub required for Matter WiFi mode", "description": "No hub required for Matter over WiFi. Thread mode requires a Thread Border Router (sold separately). Philips Hue Bridge required only for Hue app advanced features — not for Matter operation." },
{ "@type": "PropertyValue", "name": "Voltage", "value": "120", "unitCode": "VLT", "description": "120V AC — standard US residential voltage. Not compatible with 12V or 24V low-voltage circuits." },
{ "@type": "PropertyValue", "name": "Lifespan", "value": "25000", "unitCode": "HUR", "description": "25,000-hour rated life. At 3 hours/day average use: approximately 22 years. At 8 hours/day: approximately 8.5 years. Cost per hour at $15 bulb price: $0.0006/hr vs $0.001/hr for $1 incandescent at 1,000 hours." },
{ "@type": "PropertyValue", "name": "Indoor/Outdoor Use", "value": "Indoor only — not IP rated", "description": "Rated for dry and damp indoor locations only. Not rated for outdoor use. No IP rating." },
{ "@type": "PropertyValue", "name": "Warranty", "value": "2-year limited manufacturer warranty" }
],
"offers": {
"@type": "Offer",
"price": "49.99",
"priceCurrency": "USD",
"availability": "https://schema.org/InStock",
"url": "https://example-lighting.myshopify.com/products/philips-hue-a19-e26-matter"
}
}
</script>
Outdoor Floodlight Schema — PAR38 IP65 LED Example
Outdoor fixtures require IP rating, beam angle, and daylight CCT in structured data. The PAR38 example covers a dimmable outdoor floodlight with UL 1598 listing and 25,000-hour LED lifespan — the full outdoor lighting spec set.
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Cree Lighting PAR38 Outdoor LED Floodlight — 1500 Lumens, 5000K Daylight, E26, IP65, Dimmable, 25000hr",
"description": "Cree Lighting PAR38 LED outdoor floodlight with E26 medium screw base. 1500 lumens, 5000K daylight color temperature, 40-degree flood beam angle. IP65 rated — dust-tight and water jet resistant, suitable for covered outdoor fixtures, wet-location recessed cans, and outdoor security lighting. Dimmable with leading-edge and trailing-edge dimmers. CRI 90+. UL Listed UL 1598. 25,000-hour LED lifespan. ENERGY STAR certified.",
"sku": "PAR38-1500LM-5000K-E26-IP65",
"mpn": "PAR38HD-17W-E26-50K-F40",
"brand": { "@type": "Brand", "name": "Cree Lighting" },
"hasCertification": [
{
"@type": "Certification",
"name": "UL Listed — UL 1598",
"issuedBy": {
"@type": "Organization",
"name": "UL (Underwriters Laboratories)",
"url": "https://www.ul.com"
},
"certificationIdentification": "UL 1598",
"description": "UL 1598 — Luminaires. UL Listed for wet-location outdoor use. Required for luminaires installed in wet, damp, or dry locations in the US and Canada."
},
{
"@type": "Certification",
"name": "ENERGY STAR Certified",
"issuedBy": {
"@type": "Organization",
"name": "U.S. Environmental Protection Agency (EPA)",
"url": "https://www.energystar.gov"
},
"description": "ENERGY STAR certified LED lamp. Meets EPA performance standards for efficacy, lifespan (minimum 15,000 hours), CRI (minimum 80), and lumen maintenance. FTC Lighting Facts label compliant."
}
],
"additionalProperty": [
{ "@type": "PropertyValue", "name": "Bulb Type", "value": "LED Floodlight" },
{ "@type": "PropertyValue", "name": "Bulb Shape", "value": "PAR38", "description": "PAR38 parabolic aluminized reflector — 4.75 inch (120mm) diameter. Standard outdoor flood and spot lamp shape for recessed cans, outdoor wall packs, and landscape up-lights." },
{ "@type": "PropertyValue", "name": "Bulb Base Type", "value": "E26", "description": "E26 medium screw base — US standard 26mm diameter Edison screw. Fits standard outdoor recessed PAR38 cans, outdoor wall sconces with medium base, and outdoor security light fixtures." },
{ "@type": "PropertyValue", "name": "Lumens", "value": "1500", "unitCode": "LUM", "description": "1500 lumens — equivalent brightness to a 100-watt incandescent PAR38 floodlight. Suitable for security lighting, outdoor pathway illumination, and wide-area flood applications." },
{ "@type": "PropertyValue", "name": "Wattage", "value": "17", "unitCode": "W", "description": "17 watts actual energy consumption. Replaces 100W incandescent PAR38. Efficacy: 88 lm/W." },
{ "@type": "PropertyValue", "name": "Replacement Equivalent Watts", "value": "100", "unitCode": "W", "description": "Replaces a 100-watt incandescent PAR38 floodlight based on 1500 lumen equivalency." },
{ "@type": "PropertyValue", "name": "Color Temperature (CCT)", "value": "5000", "unitCode": "KEL", "description": "5000K Daylight — crisp, bright white light with a slightly bluish cast. Ideal for outdoor security lighting, garage lighting, task lighting, and security cameras (improves nighttime camera performance at 5000K vs 2700K). Not recommended for residential ambiance or decorative fixtures." },
{ "@type": "PropertyValue", "name": "CRI (Color Rendering Index)", "value": "90", "description": "CRI 90+ — premium color rendering. Objects and landscapes appear true-to-life under this light. Suitable for outdoor retail signage, landscape architectural lighting, and commercial exterior applications where color accuracy matters." },
{ "@type": "PropertyValue", "name": "Color Capability", "value": "Fixed White", "description": "Fixed White at 5000K — no color adjustment. Single color temperature, no app or smart control required." },
{ "@type": "PropertyValue", "name": "Beam Angle", "value": "40", "description": "40-degree flood beam angle. Covers a wide area with broad, even illumination. For narrower spot applications, PAR38 is also available in 25-degree spot and 15-degree narrow spot configurations." },
{ "@type": "PropertyValue", "name": "Dimmable", "value": "true", "description": "Dimmable on standard leading-edge (incandescent/halogen) and trailing-edge (electronic low-voltage) TRIAC dimmers. Compatible with most standard residential dimmers from Lutron, Leviton, and GE. Smooth dimming from 5%–100% with no flicker." },
{ "@type": "PropertyValue", "name": "Compatible Dimmer Type", "value": "Leading Edge / Trailing Edge (Universal)", "description": "Universal dimmer compatibility — works with leading-edge TRIAC dimmers (for incandescent/halogen) and trailing-edge electronic low-voltage dimmers. Verify dimmer compatibility with the dimmer manufacturer's LED bulb compatibility list for flicker-free performance." },
{ "@type": "PropertyValue", "name": "IP Rating", "value": "IP65", "description": "IP65 — Ingress Protection rating: 6 (dust-tight, completely protected against dust ingress) + 5 (protected against water jets from any direction). Suitable for outdoor covered fixtures, outdoor wall-mounted sconces, and wet-location recessed cans. IP65 is the minimum rating for true outdoor floodlight reliability. Not rated for IP67 (temporary immersion) or IP68 (continuous submersion)." },
{ "@type": "PropertyValue", "name": "Indoor/Outdoor Use", "value": "Outdoor — wet location rated", "description": "Rated for outdoor wet locations. Suitable for use in open fixtures exposed to rain. Verify fixture is also wet-location rated — the bulb IP rating does not substitute for fixture location rating." },
{ "@type": "PropertyValue", "name": "Voltage", "value": "120", "unitCode": "VLT", "description": "120V AC — standard US residential voltage." },
{ "@type": "PropertyValue", "name": "Lifespan", "value": "25000", "unitCode": "HUR", "description": "25,000-hour rated life (L70 — maintains 70% of initial lumens at end of rated life). At 12 hours/day outdoor security use: approximately 5.7 years. Cost per hour at $12 bulb price: $0.00048/hr vs incandescent PAR38 at $3 / 2000 hours = $0.0015/hr." },
{ "@type": "PropertyValue", "name": "Warranty", "value": "5-year limited manufacturer warranty" }
],
"offers": {
"@type": "Offer",
"price": "19.99",
"priceCurrency": "USD",
"availability": "https://schema.org/InStock",
"url": "https://example-lighting.myshopify.com/products/par38-led-floodlight-5000k-ip65"
}
}
Color Temperature (CCT) Reference Table
Color temperature in Kelvin (K) is the second most common lighting query attribute after base type. AI agents need the numeric CCT value (unitCode KEL) plus descriptive text covering the common-language equivalents ("warm white," "cool white," "daylight") so both numeric and descriptive queries match.
| CCT (Kelvin) | Label | Typical Use | Ambiance / Visual Character |
|---|---|---|---|
2700K |
Warm White | Residential living rooms, bedrooms, dining rooms, table lamps | Soft golden-amber glow — matches incandescent. Relaxing, intimate. Recommended for spaces where warmth and comfort matter. |
3000K |
Warm White | Kitchens, bathrooms, retail (clothing, food, hospitality) | Warm white but slightly crisper than 2700K. Better for task lighting while retaining warmth. Popular in upscale retail and restaurants. |
3500K |
Neutral White | Offices, schools, commercial interiors, hallways | Neutral balance between warm and cool. Neither inviting nor harsh. Common in commercial construction. |
4000K |
Cool White | Garages, workshops, utility rooms, task lighting, commercial kitchens | Cool, slightly blue-white. Promotes alertness and focus. Enhances visibility for detailed work. Commonly specified in commercial applications. |
5000K |
Daylight | Outdoor security, basements, warehouses, display lighting, security cameras | Bright crisp white matching mid-day sunlight. Maximizes visual acuity. Preferred by security camera manufacturers for color accuracy at night. |
6500K |
Daylight Blue | Aquariums, display lighting, photography studios, plant grow lights | Blue-tinted white light. Simulates overcast sky. Used in specialized applications — generally not recommended for general residential use. |
Bulb Base Type Compatibility Reference
Bulb base type is the most critical compatibility attribute in lighting — wrong base type = guaranteed return. Every lighting product page must encode base type as a structured additionalProperty with diameter and compatible fixture types in the description.
| Base Type | Diameter / Config | Common Fixtures | Voltage / Notes |
|---|---|---|---|
E26 |
26mm screw | Standard US lamps, floor lamps, table lamps, pendants, ceiling fixtures, ceiling fans | 120V AC. US standard medium base. Most common base in the US. |
E27 |
27mm screw | European standard lamps, luminaires — same form factor as E26 but slightly different thread | 230V AC (EU). Physically similar to E26 but voltage and thread differ. Not interchangeable in safety-critical applications despite physical fit. |
E12 |
12mm screw | Chandeliers, candelabra fixtures, decorative sconces, nightlights, ceiling fan accent bulbs | 120V AC. US candelabra base. Small form factor — commonly used in decorative B11 or CA10 bulb shapes. |
E14 |
14mm screw | European chandeliers, decorative fixtures, European appliance bulbs | 230V AC (EU). European small screw base equivalent to E12. |
GU10 |
10mm pin spacing, twist-lock | Halogen track lighting, recessed downlights (MR16-style), directional spot fixtures, under-cabinet track | 120V AC. Two pins, rotates 90 degrees to lock. Direct mains voltage — no transformer required (unlike MR16). |
GU24 |
24mm pin spacing, twist-lock | Energy-code-compliant residential fixtures (California Title 24, IECC), table lamps designed for efficient bulbs | 120V AC. Two-pin twist-lock designed to prevent use of non-efficient incandescent bulbs. Common in California and energy-code jurisdictions. |
G4 / G9 |
4mm / 9mm bi-pin | Accent lighting, under-cabinet halogen pucks, landscape path lights, jewelry display cases, cabinet lights | G4: typically 12V DC/AC (needs transformer). G9: 120V/230V mains. Check fixture voltage before selecting G4 LED replacements. |
MR16 |
16×2mm = 32mm reflector, bi-pin GU5.3 | 12V low-voltage track lighting, recessed MR16 downlights, landscape spotlights | 12V AC/DC — requires a low-voltage transformer. Check transformer compatibility with LED driver before substituting LED for halogen MR16. |
PAR20 |
2.5" diameter, E26 base | Small recessed cans (4" can), track lighting, accent lighting | 120V AC, E26 base. Flood or spot beam. Typically 250–400 lumens for LED replacement. |
PAR30 |
3.75" diameter, E26 base | Medium recessed cans (5" can), retail track lighting, outdoor accent | 120V AC, E26 base. Available in long neck (PAR30L) and short neck (PAR30S) — verify fixture depth. |
PAR38 |
4.75" diameter, E26 base | Large recessed cans (6" can), outdoor security floods, commercial track, landscape up-lights | 120V AC, E26 base. Most common outdoor floodlight shape. Available in 25°, 40°, 60° beam angles — specify beam angle as separate additionalProperty. |
EnergyConsumptionDetails and ENERGY STAR Certification
ENERGY STAR certified LED bulbs must meet the EPA's minimum requirements: rated lumens at rated wattage (efficacy), rated life (minimum 15,000 hours for most categories), CRI (minimum 80), lumen maintenance (L70 — must maintain 70% of initial lumens at end of rated life), and starting time (<1 second). The FTC Lighting Facts label is required on all LED bulb packaging sold in the US.
For EU products, use the EnergyConsumptionDetails schema type with hasEnergyEfficiencyCategory linked to the EU A–G energy label. From 2021, all EU LED lamps reset to the A–G scale (previously A++ to E): most good LEDs currently land in C or D, with top-tier products reaching B or A. Include both the schema.org EnergyConsumptionDetails block and the raw efficacy in lumens-per-watt in your additionalProperty.
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Example LED Bulb — EU Energy Label Class C",
"hasEnergyConsumptionDetails": {
"@type": "EnergyConsumptionDetails",
"hasEnergyEfficiencyCategory": "https://schema.org/EUEnergyEfficiencyCategoryC",
"energyEfficiencyScaleMin": "https://schema.org/EUEnergyEfficiencyCategoryG",
"energyEfficiencyScaleMax": "https://schema.org/EUEnergyEfficiencyCategoryA"
}
}
DLC (DesignLights Consortium) for Commercial LED
For commercial and industrial LED products — high-bay fixtures, troffers, outdoor area lights, and linear luminaires — the DLC QPL (Qualified Products List) is the primary certification for utility rebate eligibility. A DLC listing unlocks rebates from hundreds of US electric utilities. Include the DLC product number in certificationIdentification:
{
"@type": "Certification",
"name": "DLC Listed — DesignLights Consortium QPL",
"issuedBy": {
"@type": "Organization",
"name": "DesignLights Consortium (DLC)",
"url": "https://www.designlights.org"
},
"certificationIdentification": "DLC product number from designlights.org/qualified-products",
"description": "DLC QPL listing qualifies this fixture for utility energy efficiency rebates across participating US utility programs. DLC Premium tier available for top-efficacy products."
}
Dawn Liquid Snippet: lighting.* Metafield Namespace
Save as snippets/lighting-product-schema.liquid. Activates for products tagged light-bulb, led-bulb, smart-bulb, light-fixture, or in the lighting collection.
{% comment %} lighting-product-schema.liquid — home lighting structured data {% endcomment %}
{% assign is_lighting = false %}
{% if product.tags contains 'light-bulb' or product.tags contains 'led-bulb' or product.tags contains 'smart-bulb' or product.tags contains 'light-fixture' or product.tags contains 'lamp' %}
{% assign is_lighting = true %}
{% endif %}
{% for collection in product.collections %}
{% if collection.handle == 'lighting' or collection.handle == 'light-bulbs' or collection.handle == 'smart-lighting' %}
{% assign is_lighting = true %}
{% endif %}
{% endfor %}
{% if is_lighting %}
{% assign bulb_base = product.metafields.lighting.bulb_base %}
{% assign lumens = product.metafields.lighting.lumens %}
{% assign cct_k = product.metafields.lighting.color_temp_k %}
{% assign cri = product.metafields.lighting.cri %}
{% assign wattage = product.metafields.lighting.wattage %}
{% assign dimmable = product.metafields.lighting.dimmable %}
{% assign color_cap = product.metafields.lighting.color_capability %}
{% assign wireless_proto = product.metafields.lighting.wireless_protocol %}
{% assign ip_rating = product.metafields.lighting.ip_rating %}
{% assign lifespan_hrs = product.metafields.lighting.lifespan_hours %}
{% assign beam_angle = product.metafields.lighting.beam_angle %}
{% assign voltage = product.metafields.lighting.voltage %}
{% assign bulb_type = product.metafields.lighting.bulb_type %}
{% assign energy_star = product.metafields.lighting.energy_star %}
{% assign equiv_watts = product.metafields.lighting.replacement_equiv_watts %}
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Product",
"name": {{ product.title | json }},
"description": {{ product.description | strip_html | truncatewords: 80 | json }},
"url": "{{ shop.url }}{{ product.url }}",
"sku": {{ product.selected_or_first_available_variant.sku | json }}
{% if product.selected_or_first_available_variant.barcode != blank %}
,"gtin": {{ product.selected_or_first_available_variant.barcode | json }}
{% endif %}
{% if product.vendor != blank %}
,"brand": { "@type": "Brand", "name": {{ product.vendor | json }} }
{% endif %}
{% if energy_star == "true" or energy_star == true %}
,"hasCertification": [
{
"@type": "Certification",
"name": "ENERGY STAR Certified",
"issuedBy": {
"@type": "Organization",
"name": "U.S. Environmental Protection Agency (EPA)",
"url": "https://www.energystar.gov"
}
}
]
{% endif %}
,"additionalProperty": [
{% assign ap_s = false %}
{% if bulb_type != blank %}
{ "@type": "PropertyValue", "name": "Bulb Type", "value": {{ bulb_type | json }} }
{% assign ap_s = true %}
{% endif %}
{% if bulb_base != blank %}
{% if ap_s %},{% endif %}{ "@type": "PropertyValue", "name": "Bulb Base Type", "value": {{ bulb_base | json }} }
{% assign ap_s = true %}
{% endif %}
{% if lumens != blank %}
,{ "@type": "PropertyValue", "name": "Lumens", "value": {{ lumens | json }}, "unitCode": "LUM" }
{% endif %}
{% if wattage != blank %}
,{ "@type": "PropertyValue", "name": "Wattage", "value": {{ wattage | json }}, "unitCode": "W" }
{% endif %}
{% if equiv_watts != blank %}
,{ "@type": "PropertyValue", "name": "Replacement Equivalent Watts", "value": {{ equiv_watts | json }}, "unitCode": "W" }
{% endif %}
{% if cct_k != blank %}
,{ "@type": "PropertyValue", "name": "Color Temperature (CCT)", "value": {{ cct_k | json }}, "unitCode": "KEL" }
{% endif %}
{% if cri != blank %}
,{ "@type": "PropertyValue", "name": "CRI (Color Rendering Index)", "value": {{ cri | json }} }
{% endif %}
{% if color_cap != blank %}
,{ "@type": "PropertyValue", "name": "Color Capability", "value": {{ color_cap | json }} }
{% endif %}
{% if dimmable != blank %}
,{ "@type": "PropertyValue", "name": "Dimmable", "value": {{ dimmable | json }} }
{% endif %}
{% if wireless_proto != blank %}
,{ "@type": "PropertyValue", "name": "Wireless Protocol", "value": {{ wireless_proto | json }} }
{% endif %}
{% if ip_rating != blank %}
,{ "@type": "PropertyValue", "name": "IP Rating", "value": {{ ip_rating | json }} }
{% endif %}
{% if lifespan_hrs != blank %}
,{ "@type": "PropertyValue", "name": "Lifespan", "value": {{ lifespan_hrs | json }}, "unitCode": "HUR" }
{% endif %}
{% if beam_angle != blank %}
,{ "@type": "PropertyValue", "name": "Beam Angle", "value": {{ beam_angle | json }} }
{% endif %}
{% if voltage != blank %}
,{ "@type": "PropertyValue", "name": "Voltage", "value": {{ voltage | json }}, "unitCode": "VLT" }
{% endif %}
]
,"offers": {
"@type": "Offer",
"price": {{ product.selected_or_first_available_variant.price | money_without_currency | json }},
"priceCurrency": {{ cart.currency.iso_code | json }},
"availability": {% if product.available %}"https://schema.org/InStock"{% else %}"https://schema.org/OutOfStock"{% endif %},
"url": "{{ shop.url }}{{ product.url }}"
}
}
</script>
{% endif %}
lighting.* metafield namespace
| Metafield | Type | Example values |
|---|---|---|
lighting.bulb_base | Single line text | E26, E12, GU10, GU24, PAR38, MR16, G9, E27 |
lighting.lumens | Integer | 450, 800, 1100, 1500, 2600 |
lighting.color_temp_k | Integer or text range | 2700, 3000, 5000, 2000-6500 (for tunable) |
lighting.cri | Integer | 80, 90, 92, 95 |
lighting.wattage | Decimal | 4.5, 9, 10, 17, 60 |
lighting.dimmable | Boolean | true, false |
lighting.color_capability | Single line text | Fixed White, Tunable White (CCT adjustable), Full Color RGB+W |
lighting.wireless_protocol | Single line text | Matter 1.2, Zigbee 3.0, WiFi 802.11 b/g/n 2.4GHz, Bluetooth 5.0 |
lighting.ip_rating | Single line text | IP44, IP65, IP67 (blank for indoor-only) |
lighting.lifespan_hours | Integer | 1000, 2000, 15000, 25000 |
lighting.beam_angle | Integer | 15, 25, 40, 60, 120 (degrees) |
lighting.voltage | Integer | 12, 120, 230 |
lighting.bulb_type | Single line text | LED, Smart LED, Halogen, Incandescent, CFL |
lighting.energy_star | Boolean | true, false |
lighting.replacement_equiv_watts | Integer | 40, 60, 75, 100 (incandescent equivalent) |
5 Common Lighting Schema Mistakes
| # | Mistake | Impact | Fix |
|---|---|---|---|
| 1 | Listing watts but not lumens in structured data | Brightness queries — "800 lumen bulb," "equivalent to 60W," "brightest E26 under 10 watts" — require lumens for the primary spec match. Watts alone cannot answer "how bright is this?" Shoppers increasingly search by lumens as incandescent familiarity declines, and AI agents have adopted lumen-based filtering as the primary brightness metric | Add additionalProperty Lumens with unitCode: "LUM" and Wattage with unitCode: "W" as separate entries. Also add Replacement Equivalent Watts to catch incandescent-thinking queries |
| 2 | Missing or incorrect base type in structured data | Base type is the #1 cause of lighting returns and the most critical compatibility attribute. A buyer who searches "GU10 LED 5000K" will not be shown E26 products — and cannot use them even if shown. Without structured base type, AI agents cannot filter by socket compatibility, and compatibility queries return no confident match | Add additionalProperty Bulb Base Type with the exact base designation (E26, GU10, PAR38, MR16, etc.) and a description field listing compatible fixture types and socket diameter |
| 3 | Dimmable attribute absent or expressed only in title text | Non-dimmable bulbs installed on dimmer circuits can flicker, buzz, overheat, or fail prematurely — a critical safety and performance issue. Buyers specifically filter for dimmable when they have dimmer switches. Title text like "non-dimmable" is not machine-readable as a boolean filter. Even dimmable bulbs without dimmer-type information can cause flicker on mismatched dimmer circuits | Add additionalProperty Dimmable as explicit boolean (true or false). Also add compatibleDimmerType (Leading Edge / Trailing Edge / Universal / Smart Dimmer Only) to prevent dimmer mismatch failures |
| 4 | No CRI specified for retail, hospitality, or color-critical stores | Retail display lighting, jewelry stores, art galleries, restaurants, dressing rooms, and photography studios require CRI 90+ for accurate color rendering. Buyers in these segments specifically search for "CRI 90 track lighting" or "high CRI retail LED." Without a structured CRI value, these high-value commercial purchases are unmatched — and the product may be returned when colors appear dull or inaccurate under the fixture | Add additionalProperty CRI (Color Rendering Index) with the numeric value (no unitCode). Include threshold context in description: CRI 90+ = premium, 80-89 = residential, below 80 = commercial/utility |
| 5 | Smart bulb wireless protocol without hub dependency disclosure | Zigbee smart bulbs require a Zigbee hub (Hue Bridge, SmartThings Hub, IKEA Dirigera) to function — a hidden $50–$100+ additional purchase. WiFi smart bulbs require 2.4GHz band only and will not connect to 5GHz networks. Matter bulbs need a Thread Border Router for Thread mode. Omitting hub requirements creates customer dissatisfaction, increased support tickets, and high return rates — especially for first-time smart lighting buyers | Add additionalProperty Wireless Protocol and Hub Requirement as separate entries. In Hub Requirement, explicitly state whether a hub is required, which hubs are compatible, and whether the hub is sold separately. Use compatibleWith to list each supported smart ecosystem |
Frequently Asked Questions
How do I express lumens and watts in schema.org?
Use separate additionalProperty PropertyValue entries: { "name": "Lumens", "value": "800", "unitCode": "LUM" } for light output and { "name": "Wattage", "value": "9", "unitCode": "W" } for energy consumption. The UN/CEFACT unitCode for lumens is LUM and for watts is W. Add a third property for Replacement Equivalent Watts to catch "replaces 60W bulb" searches. Never list watts without lumens — AI agents cannot compute brightness from watts alone because efficacy varies enormously between LED, halogen, and incandescent technologies.
How do I encode bulb base type compatibility in schema.org?
Add additionalProperty with name: "Bulb Base Type" and the exact base code (E26, E12, GU10, PAR38, MR16, etc.) as the value. Include diameter and compatible fixture types in the description field. For PAR-series bulbs, add a separate Bulb Shape property (PAR20, PAR30, PAR38) and a Beam Angle property in degrees. Base type mismatch is the leading cause of lighting returns, so include specific fixture compatibility examples in the description ("fits standard US floor lamps, table lamps, ceiling fixtures").
How do I implement smart bulb wireless protocol in schema.org?
Add additionalProperty with name: "Wireless Protocol" and values like "Matter 1.2", "Zigbee 3.0", or "WiFi 802.11 b/g/n 2.4GHz". Add a separate Hub Requirement property disclosing whether a hub is needed and which hubs are compatible. Use compatibleWith to explicitly list each smart ecosystem (Apple HomeKit, Google Home, Amazon Alexa, Samsung SmartThings). Matter bulbs are ecosystem-agnostic by design; Zigbee requires a hub; WiFi is hub-free but 2.4GHz only. These distinctions are critical purchase signals that AI agents must surface in smart home queries.
What CRI value should I specify for retail lighting products?
CRI (Color Rendering Index) is a plain number from 0–100 with no UN/CEFACT unitCode — use { "name": "CRI (Color Rendering Index)", "value": "92" }. For retail display, jewelry, art galleries, dressing rooms, and color-critical applications, specify CRI 90+ and state this explicitly in the description: "CRI 92 — premium true-color rendering for retail display, jewelry cases, and dressing rooms." For standard residential, CRI 80–89 is acceptable. Below CRI 80 is appropriate only for utility and commercial applications where color accuracy is not a priority.
How do I encode ENERGY STAR certification for LED bulbs in schema.org?
Use hasCertification with name: "ENERGY STAR Certified", issuedBy.name: "U.S. Environmental Protection Agency (EPA)", and certificationIdentification set to the bulb's ENERGY STAR registration ID (find it at energystar.gov/productfinder). ENERGY STAR LED bulbs must meet minimum efficacy (lumens per watt), minimum lifespan (typically 15,000+ hours), CRI ≥ 80, lumen maintenance (L70), and FTC Lighting Facts label requirements. For EU products, supplement with hasEnergyConsumptionDetails using the EU A–G energy efficiency category.
Are your lighting product lumen, CCT, and base type signals invisible to AI shopping agents?
CatalogScan audits your Shopify store for missing lumens, absent color temperature data, unstructured base type claims, and missing ENERGY STAR certification markup — the four most common AI agent visibility gaps for lighting product pages.
Run Free Scan