{
  "version": "0.1.0-alpha",
  "publishedAt": "2026-09-05",
  "states": ["KNOWN", "UNKNOWN", "NOT_APPLICABLE", "WITHHELD"],
  "fields": [
    {"id":"brand.name","label":"Brand name","entity":"brand","type":"localized_string","group":"identity","description":"Authoritative public brand name.","applicability":"all branded products"},
    {"id":"brand.website","label":"Brand website","entity":"brand","type":"url","group":"identity","description":"Canonical public website for the brand.","applicability":"when a public site exists"},
    {"id":"product.title","label":"Product title","entity":"variant","type":"localized_string","group":"content","description":"Approved title at the purchasable variant grain.","applicability":"active products"},
    {"id":"product.description","label":"Description","entity":"product","type":"localized_string","group":"content","description":"Factual product description, excluding unsupported claims.","applicability":"active products"},
    {"id":"product.category","label":"Canonical category","entity":"product","type":"taxonomy_reference","group":"classification","description":"Channel-neutral product classification.","applicability":"active products"},
    {"id":"product.product_type","label":"Merchant product type","entity":"product","type":"string","group":"classification","description":"Merchant-defined product hierarchy or type.","applicability":"when maintained"},
    {"id":"family.varies_by","label":"Variant axes","entity":"product_family","type":"string_array","group":"relationships","description":"Ordered option axes that distinguish members of a family.","applicability":"products with variants"},
    {"id":"variant.option_values","label":"Variant option values","entity":"variant","type":"object","group":"relationships","description":"One value for every declared family axis.","applicability":"products with variants"},
    {"id":"identifier.sku","label":"SKU","entity":"variant","type":"string","group":"identity","description":"Merchant-controlled stock keeping identifier.","applicability":"when merchant uses SKUs"},
    {"id":"identifier.gtin","label":"GTIN","entity":"variant","type":"string","group":"identity","description":"GS1 Global Trade Item Number assigned to the trade item.","applicability":"when legitimately assigned"},
    {"id":"identifier.mpn","label":"MPN","entity":"variant","type":"string","group":"identity","description":"Manufacturer part number.","applicability":"when assigned by manufacturer"},
    {"id":"attribute.color","label":"Colour","entity":"variant","type":"localized_string","group":"attributes","description":"Standardized colour description.","applicability":"colour-bearing products"},
    {"id":"attribute.size","label":"Size","entity":"variant","type":"string","group":"attributes","description":"Size value interpreted with size system and type where relevant.","applicability":"sized products"},
    {"id":"attribute.material","label":"Material","entity":"product","type":"string_array","group":"attributes","description":"Primary materials or substances.","applicability":"material-relevant categories"},
    {"id":"attribute.gender","label":"Target gender","entity":"product","type":"controlled_string","group":"attributes","description":"Target-gender classification where the category requires it.","applicability":"category and destination dependent"},
    {"id":"attribute.age_group","label":"Age group","entity":"product","type":"controlled_string","group":"attributes","description":"Intended age group where applicable.","applicability":"category and destination dependent"},
    {"id":"media.primary_image_url","label":"Primary image URL","entity":"variant","type":"url","group":"media","description":"Stable public HTTPS URL for the primary product image.","applicability":"active products"},
    {"id":"media.additional_image_urls","label":"Additional image URLs","entity":"variant","type":"url_array","group":"media","description":"Supplementary product image URLs.","applicability":"when available"},
    {"id":"offer.url","label":"Offer URL","entity":"offer","type":"url","group":"commerce","description":"Canonical public landing page for the offer.","applicability":"public online offers"},
    {"id":"offer.price","label":"Price","entity":"offer","type":"money","group":"commerce","description":"Typed amount and ISO 4217 currency for a market.","applicability":"sellable offers"},
    {"id":"offer.availability","label":"Availability","entity":"offer","type":"controlled_string","group":"commerce","description":"Governed state: in_stock, out_of_stock, preorder, or backorder.","applicability":"sellable offers"},
    {"id":"offer.condition","label":"Condition","entity":"offer","type":"controlled_string","group":"commerce","description":"Condition of the offered item.","applicability":"destination or category dependent"},
    {"id":"offer.market","label":"Market","entity":"offer","type":"country_code","group":"commerce","description":"ISO 3166-1 alpha-2 target market.","applicability":"offers"},
    {"id":"offer.seller_name","label":"Seller name","entity":"offer","type":"string","group":"commerce","description":"Seller responsible for the offer.","applicability":"offers"},
    {"id":"offer.price_observed_at","label":"Price observed at","entity":"offer","type":"date_time","group":"freshness","description":"Timestamp for the source price observation.","applicability":"dynamic offers"},
    {"id":"offer.availability_observed_at","label":"Availability observed at","entity":"offer","type":"date_time","group":"freshness","description":"Timestamp for the source availability observation.","applicability":"dynamic offers"}
  ]
}