XooCode(){

EnergyConsumptionDetails

EnergyConsumptionDetails carries the energy-efficiency label attached to an Offer, Product, or Vehicle: the regulatory classification required under EU directive 2017/1369 ("energy labelling framework regulation") and under US Energy Policy and Conservation Act rules.

It is an Intangible (not a StructuredValue) and adds 3 direct properties:

  • hasEnergyEfficiencyCategory: an EnergyEfficiencyEnumeration value: EUEnergyEfficiencyCategoryA through G, or the enhanced A1Plus / A2Plus / A3Plus tiers.
  • energyEfficiencyScaleMin: the lowest class available on this product's scale.
  • energyEfficiencyScaleMax: the highest class available on this product's scale.

The min/max bounds matter because EU scales are product-category-specific: a washing machine's A-G range is different from a refrigerator's A-G range. Publishing the scale bounds lets consumers render the label correctly.

Full example of schema.org/EnergyConsumptionDetails json-ld markup

The markup is verified as valid with Rich Results Test from Google.

Highlight legend:Required by GoogleRecommendedOptional
schema.org/EnergyConsumptionDetails
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Offer",
  "itemOffered": {
    "@type": "Product",
    "name": "XooLite T-200 LED Stage Lamp",
    "sku": "XOO-LITE-T200",
    "brand": { "@type": "Brand", "name": "XooLite" }
  },
  "price": 429.00,
  "priceCurrency": "EUR",
  "hasEnergyConsumptionDetails": {
    "@type": "EnergyConsumptionDetails",
    "hasEnergyEfficiencyCategory": "https://schema.org/EUEnergyEfficiencyCategoryA",
    "energyEfficiencyScaleMin": "https://schema.org/EUEnergyEfficiencyCategoryG",
    "energyEfficiencyScaleMax": "https://schema.org/EUEnergyEfficiencyCategoryA"
  }
}
</script>

Where to attach it

Use Offer.hasEnergyConsumptionDetails (or Product.hasEnergyConsumptionDetails) for appliances. For vehicles, also consider Car.fuelConsumption / fuelEfficiency / emissionsCO2.

Minimal valid version

The smallest markup that still produces a valid EnergyConsumptionDetails entity. Use it as the floor. Reach for the advanced example above when you want search engines and AI agents to understand more about your content.

schema.org/EnergyConsumptionDetails (minimal)
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "EnergyConsumptionDetails",
  "hasEnergyEfficiencyCategory": "https://schema.org/EUEnergyEfficiencyCategoryA",
  "energyEfficiencyScaleMin": "https://schema.org/EUEnergyEfficiencyCategoryG",
  "energyEfficiencyScaleMax": "https://schema.org/EUEnergyEfficiencyCategoryA"
}
</script>

Google rich results this unlocks

Markup matching this example makes your page eligible for the following Google Search rich results. The primary target drives the required / recommended property classification in the advanced code block above.

  • No dedicated rich result (used by EU / US regulatory consumers and shopping aggregators)
    Google docs

Common EnergyConsumptionDetails mistakes

Mistakes that pass validation but silently fail to earn rich results or mislead consumers walking the graph. Avoid these and your markup will be ahead of most sites in the wild.

  1. 01

    hasEnergyEfficiencyCategory as a bare letter

    Wrong
    "hasEnergyEfficiencyCategory": "A"
    Right
    The full enumeration URL https://schema.org/EUEnergyEfficiencyCategoryA

    hasEnergyEfficiencyCategory is enumeration-valued; a bare letter breaks machine resolution.

  2. 02

    Omitting scale min/max

    Wrong
    Only hasEnergyEfficiencyCategory populated
    Right
    Always publish energyEfficiencyScaleMin and energyEfficiencyScaleMax so consumers know which slice of the A-G scale applies

    Different appliance categories use different segments of the A-G scale; without the bounds, consumers cannot render an accurate label.

  3. 03

    Using pre-2021 EU labels

    Wrong
    EUEnergyEfficiencyCategoryA3Plus on a 2026 fridge
    Right
    Post-2021 EU rescaling dropped the A+/A++/A+++ tiers for most categories; use the A-G scale

    The A1Plus/A2Plus/A3Plus enum values remain in schema.org for back-compatibility, but current EU labels are A-G for most appliances.

Schema properties in this example

EnergyConsumptionDetailsIntangibleOfferitemOfferedProductskubrandBrandpricepriceCurrencyhasEnergyConsumptionDetailshasEnergyEfficiencyCategoryenergyEfficiencyScaleMinenergyEfficiencyScaleMaxEUEnergyEfficiencyEnumerationEUEnergyEfficiencyCategoryAEUEnergyEfficiencyCategoryG

About the example data

A fictional A-rated energy-efficient LED stage lamp sold for The Thunderdome's touring rigs, EU-labelled A on an A-G scale.

Comments

Loading comments...

Leave a comment