{"source":{"url":"https://ontology.live/o/e-commerce-product-listing-ontology-81a917","author":"@ssergienko","license":"CC BY 4.0","licenseUrl":"https://creativecommons.org/licenses/by/4.0/","publishedAt":"2026-10-21T19:39:39.837Z"},"ontology":{"name":"E-commerce Product Listing Ontology","description":"Models structured online retail product detail page text (title, pricing, availability, features, specifications, variants, policies). Used to generate new realistic product listings across categories from a short prompt.","domain":"retail"},"graph":{"nodes":[{"id":"product_listing","type":"class","label":"Product Listing","description":"A single product detail page/record combining identity, commercial, descriptive and policy information.","semantics":"Root entity; its category determines which specs and features appear.","examples":["Trailblaze 28L Hiking Backpack","Aurora Smart LED Bulb 4-pack"]},{"id":"title","type":"property","label":"Product Title","description":"Name line combining product line, key attribute (size, capacity, wattage) and sometimes variant or pack size.","semantics":"Format varies: name + capacity + colour, or name + technical rating + pack count.","examples":["Zenfield 15L Trail Pack — Ocean Blue","Brightia Smart Plug, 10A — 2-pack"]},{"id":"brand","type":"class","label":"Brand","description":"Manufacturer or seller brand identity shown near the title.","semantics":"Fictional brand name matched to category tone.","examples":["Peakline Gear","Voltaro"]},{"id":"identifiers","type":"property","label":"Product Identifiers","description":"SKU, model number, GTIN/EAN codes uniquely identifying the item.","semantics":"SKU encodes brand, product and variant; model used mostly for electronics.","examples":["SKU: PL-DP20-BL","Model: VT-P10-W"]},{"id":"pricing","type":"class","label":"Pricing","description":"Current price, currency, optional previous price and unit price.","semantics":"Currency symbol and format follow market (€ vs $); discounts or unit prices appear for sale or multipacks.","examples":["€49.95 (was €64.95)","$24.99 | $12.50/plug"]},{"id":"currency_market","type":"dimension","label":"Currency / Market Locale","description":"Region determining currency, units, and formatting.","semantics":"EU: €, metric, 'Colours'; US: $, voltage notes.","examples":["EUR","USD"]},{"id":"availability","type":"property","label":"Availability / Stock Status","description":"Stock state and sometimes shipping lead time or scarcity message.","semantics":"Varies between in stock with dispatch time and low-stock urgency.","examples":["In stock — ships in 1–2 business days","Only 3 left in stock"]},{"id":"rating","type":"property","label":"Ratings & Social Proof","description":"Average star rating, review count, or Q&A count.","semantics":"Optional; numeric score out of 5 with counts.","examples":["4.4/5 (128 reviews)","25 answered questions"]},{"id":"category_path","type":"property","label":"Category Path","description":"Hierarchical breadcrumb taxonomy from department to leaf category.","semantics":"Depth 3–4 levels, separated by '>'; drives spec vocabulary.","examples":["Outdoor > Camping > Sleeping Bags","Home > Lighting > Smart Bulbs"]},{"id":"product_category","type":"dimension","label":"Product Category Domain","description":"Broad product domain that determines features and specs.","semantics":"Physical goods (apparel/gear) emphasize materials and dimensions; electronics emphasize connectivity and power.","examples":["outdoor gear","smart home electronics","kitchenware"]},{"id":"summary","type":"property","label":"Short Description","description":"One-sentence tagline summarizing the product's main benefit.","semantics":"Present in some listings; concise and benefit-led.","examples":["Lightweight daypack with a ventilated back panel."]},{"id":"features","type":"class","label":"Features List","description":"Bulleted marketing-oriented list of 3–6 selling points.","semantics":"Each bullet is a short fragment mixing capability, compatibility and convenience.","examples":["Hydration-compatible","No hub required — Wi-Fi 2.4 GHz"]},{"id":"specifications","type":"class","label":"Specifications","description":"Compact key–value technical data block.","semantics":"Separated by pipes, dots or lines; keys depend on category.","examples":["Weight: 920 g","Lifespan 25,000 hours"]},{"id":"physical_specs","type":"property","label":"Physical Specs","description":"Weight, dimensions, material, capacity, colours.","semantics":"Dominant for non-electronic goods; metric or imperial by locale.","examples":["52 × 30 × 22 cm","210D recycled nylon"]},{"id":"technical_specs","type":"property","label":"Technical Specs","description":"Performance and electrical attributes such as brightness, voltage, energy class, protocol.","semantics":"Dominant for electronics; numeric with units.","examples":["806 lumens","100–240V","Energy class F"]},{"id":"variants","type":"class","label":"Variants / Options","description":"Alternative colours, sizes or pack counts, possibly with individual prices.","semantics":"Colours listed in specs or variants listed with prices.","examples":["1-pack ($12.99), 2-pack ($22.99)","Forest Green, Slate Grey"]},{"id":"box_contents","type":"property","label":"In the Box","description":"Items included with purchase or explicitly excluded.","semantics":"Mostly electronics; may note exclusions.","examples":["4 bulbs, quick-start guide","reservoir not included"]},{"id":"compatibility","type":"property","label":"Compatibility Note","description":"Ecosystem support or limitations and caveats.","semantics":"Positive support appears in features; restrictions in a note.","examples":["Not compatible with physical dimmer switches","Fits laptops up to 15\""]},{"id":"warranty","type":"property","label":"Warranty","description":"Warranty duration and type.","semantics":"Ranges from fixed years to lifetime limited.","examples":["2 years","lifetime limited warranty"]},{"id":"care","type":"property","label":"Care Instructions","description":"Maintenance guidance, mainly for textile or soft goods.","semantics":"Appears for physical goods, absent for electronics.","examples":["hand wash, air dry"]},{"id":"shipping_returns","type":"class","label":"Shipping & Returns Policy","description":"Free-shipping thresholds, return window and conditions.","semantics":"Optional footer-like line.","examples":["Free shipping over €50; 30-day free returns"]},{"id":"sustainability","type":"property","label":"Sustainability / Certification Claims","description":"Eco materials or standards certifications mentioned in specs or features.","semantics":"Adds credibility; varies by product.","examples":["PFC-free DWR","Matter certified"]},{"id":"layout_style","type":"dimension","label":"Layout Style","description":"Formatting of the listing: pipe-separated header lines, bullets (- or *), labelled sections.","semantics":"Varies between sectioned headers and inline label lines but remains terse and plain text.","examples":["Features / Specifications headers","Key features: / Technical details:"]},{"id":"price_tier","type":"dimension","label":"Price Tier","description":"Positioning from budget to premium.","semantics":"Influences price magnitude, warranty generosity and feature richness.","examples":["budget","mid-range","premium"]},{"id":"stock_state","type":"value","label":"Stock State Values","description":"Enumerated availability messages.","semantics":"Pick one per listing.","examples":["In stock","Low stock","Pre-order","Out of stock"]},{"id":"sale_state","type":"value","label":"Pricing State Values","description":"Whether listing is regular price, discounted, or multipack with unit price.","semantics":"Determines presence of 'was' price or unit price.","examples":["regular","discounted","multipack"]},{"id":"consistency_constraint","type":"constraint","label":"Internal Consistency","description":"Price, unit price and variant prices must reconcile; pack size matches title; specs match category.","semantics":"4-pack price ÷ 4 equals unit price; discounted price lower than previous.","examples":["$39.99 / 4 ≈ $10.00 per bulb"]},{"id":"brevity_constraint","type":"constraint","label":"Concise Telegraphic Style","description":"Short fragments, units always included, no long prose, typically under 200 words.","semantics":"Keeps generation compact and scannable.","examples":["Hip belt with two zip pockets"]},{"id":"placeholder_constraint","type":"constraint","label":"Identifier Format Rules","description":"SKUs are uppercase hyphenated codes; GTINs are 13 digits; fictional brands only.","semantics":"Use invented codes.","examples":["AB-XY12-GR"]},{"id":"relevance_constraint","type":"constraint","label":"Category-Appropriate Fields","description":"Only include sections relevant to the product type (care for textiles, voltage for electronics).","semantics":"Controls which optional properties are sampled.","examples":["Care for backpack; Energy class for bulb"]}],"edges":[{"source":"product_listing","target":"title","label":"has title","type":"has_property"},{"source":"product_listing","target":"brand","label":"made by","type":"relates_to"},{"source":"product_listing","target":"identifiers","label":"identified by","type":"has_property"},{"source":"product_listing","target":"pricing","label":"priced as","type":"has_property"},{"source":"product_listing","target":"availability","label":"has stock status","type":"has_property"},{"source":"product_listing","target":"rating","label":"has social proof","type":"has_property"},{"source":"product_listing","target":"category_path","label":"classified under","type":"has_property"},{"source":"product_listing","target":"summary","label":"introduced by","type":"has_property"},{"source":"features","target":"product_listing","label":"section of","type":"part_of"},{"source":"specifications","target":"product_listing","label":"section of","type":"part_of"},{"source":"physical_specs","target":"specifications","label":"kind of spec","type":"part_of"},{"source":"technical_specs","target":"specifications","label":"kind of spec","type":"part_of"},{"source":"variants","target":"product_listing","label":"offers","type":"part_of"},{"source":"variants","target":"pricing","label":"each has price","type":"relates_to"},{"source":"box_contents","target":"product_listing","label":"includes","type":"part_of"},{"source":"compatibility","target":"features","label":"qualifies","type":"relates_to"},{"source":"warranty","target":"product_listing","label":"covers","type":"part_of"},{"source":"care","target":"product_listing","label":"guidance for","type":"part_of"},{"source":"shipping_returns","target":"product_listing","label":"policy for","type":"part_of"},{"source":"sustainability","target":"specifications","label":"claimed in","type":"part_of"},{"source":"product_category","target":"specifications","label":"determines fields","type":"constrains"},{"source":"product_category","target":"category_path","label":"reflected in","type":"relates_to"},{"source":"product_category","target":"physical_specs","label":"emphasizes for goods","type":"relates_to"},{"source":"product_category","target":"technical_specs","label":"emphasizes for electronics","type":"relates_to"},{"source":"currency_market","target":"pricing","label":"sets format","type":"constrains"},{"source":"price_tier","target":"pricing","label":"scales","type":"constrains"},{"source":"price_tier","target":"warranty","label":"influences length","type":"relates_to"},{"source":"stock_state","target":"availability","label":"value of","type":"instance_of"},{"source":"sale_state","target":"pricing","label":"value of","type":"instance_of"},{"source":"consistency_constraint","target":"pricing","label":"validates","type":"constrains"},{"source":"consistency_constraint","target":"variants","label":"validates","type":"constrains"},{"source":"brevity_constraint","target":"features","label":"limits style","type":"constrains"},{"source":"placeholder_constraint","target":"identifiers","label":"formats","type":"constrains"},{"source":"relevance_constraint","target":"product_listing","label":"selects optional sections","type":"constrains"},{"source":"layout_style","target":"product_listing","label":"formats","type":"constrains"},{"source":"currency_market","target":"physical_specs","label":"sets units","type":"constrains"}]},"pipeline":{"classes":[{"id":"product_listing","label":"Product Listing","description":"A single product detail page/record combining identity, commercial, descriptive and policy information.","parent":null,"properties":[{"id":"title","label":"Product Title","description":"Name line combining product line, key attribute (size, capacity, wattage) and sometimes variant or pack size.","examples":["Zenfield 15L Trail Pack — Ocean Blue","Brightia Smart Plug, 10A — 2-pack"]},{"id":"identifiers","label":"Product Identifiers","description":"SKU, model number, GTIN/EAN codes uniquely identifying the item.","examples":["SKU: PL-DP20-BL","Model: VT-P10-W"]},{"id":"pricing","label":"Pricing","description":"Current price, currency, optional previous price and unit price.","examples":["€49.95 (was €64.95)","$24.99 | $12.50/plug"]},{"id":"availability","label":"Availability / Stock Status","description":"Stock state and sometimes shipping lead time or scarcity message.","examples":["In stock — ships in 1–2 business days","Only 3 left in stock"]},{"id":"rating","label":"Ratings & Social Proof","description":"Average star rating, review count, or Q&A count.","examples":["4.4/5 (128 reviews)","25 answered questions"]},{"id":"category_path","label":"Category Path","description":"Hierarchical breadcrumb taxonomy from department to leaf category.","examples":["Outdoor > Camping > Sleeping Bags","Home > Lighting > Smart Bulbs"]},{"id":"summary","label":"Short Description","description":"One-sentence tagline summarizing the product's main benefit.","examples":["Lightweight daypack with a ventilated back panel."]}],"relations":[{"type":"relates_to","target":"Brand","label":"made by"}],"examples":["Trailblaze 28L Hiking Backpack","Aurora Smart LED Bulb 4-pack"]},{"id":"brand","label":"Brand","description":"Manufacturer or seller brand identity shown near the title.","parent":null,"properties":[],"relations":[],"examples":["Peakline Gear","Voltaro"]},{"id":"pricing","label":"Pricing","description":"Current price, currency, optional previous price and unit price.","parent":null,"properties":[],"relations":[],"examples":["€49.95 (was €64.95)","$24.99 | $12.50/plug"]},{"id":"features","label":"Features List","description":"Bulleted marketing-oriented list of 3–6 selling points.","parent":null,"properties":[],"relations":[{"type":"part_of","target":"Product Listing","label":"section of"}],"examples":["Hydration-compatible","No hub required — Wi-Fi 2.4 GHz"]},{"id":"specifications","label":"Specifications","description":"Compact key–value technical data block.","parent":null,"properties":[],"relations":[{"type":"part_of","target":"Product Listing","label":"section of"}],"examples":["Weight: 920 g","Lifespan 25,000 hours"]},{"id":"variants","label":"Variants / Options","description":"Alternative colours, sizes or pack counts, possibly with individual prices.","parent":null,"properties":[],"relations":[{"type":"part_of","target":"Product Listing","label":"offers"},{"type":"relates_to","target":"Pricing","label":"each has price"}],"examples":["1-pack ($12.99), 2-pack ($22.99)","Forest Green, Slate Grey"]},{"id":"shipping_returns","label":"Shipping & Returns Policy","description":"Free-shipping thresholds, return window and conditions.","parent":null,"properties":[],"relations":[{"type":"part_of","target":"Product Listing","label":"policy for"}],"examples":["Free shipping over €50; 30-day free returns"]}],"dimensions":[{"id":"currency_market","label":"Currency / Market Locale","description":"Region determining currency, units, and formatting.","values":[]},{"id":"product_category","label":"Product Category Domain","description":"Broad product domain that determines features and specs.","values":[]},{"id":"layout_style","label":"Layout Style","description":"Formatting of the listing: pipe-separated header lines, bullets (- or *), labelled sections.","values":[]},{"id":"price_tier","label":"Price Tier","description":"Positioning from budget to premium.","values":[]}],"constraints":[{"id":"consistency_constraint","label":"Internal Consistency","description":"Price, unit price and variant prices must reconcile; pack size matches title; specs match category.","appliesTo":["Pricing","Variants / Options"]},{"id":"brevity_constraint","label":"Concise Telegraphic Style","description":"Short fragments, units always included, no long prose, typically under 200 words.","appliesTo":["Features List"]},{"id":"placeholder_constraint","label":"Identifier Format Rules","description":"SKUs are uppercase hyphenated codes; GTINs are 13 digits; fictional brands only.","appliesTo":["Product Identifiers"]},{"id":"relevance_constraint","label":"Category-Appropriate Fields","description":"Only include sections relevant to the product type (care for textiles, voltage for electronics).","appliesTo":["Product Listing"]}],"promptReady":"# E-commerce Product Listing Ontology\n\nModels structured online retail product detail page text (title, pricing, availability, features, specifications, variants, policies). Used to generate new realistic product listings across categories from a short prompt.\n\n**Domain:** retail\n\n## Classes\n\n### Product Listing\nA single product detail page/record combining identity, commercial, descriptive and policy information.\n\n**Properties:**\n- Product Title: Name line combining product line, key attribute (size, capacity, wattage) and sometimes variant or pack size.\n  Examples: Zenfield 15L Trail Pack — Ocean Blue, Brightia Smart Plug, 10A — 2-pack\n- Product Identifiers: SKU, model number, GTIN/EAN codes uniquely identifying the item.\n  Examples: SKU: PL-DP20-BL, Model: VT-P10-W\n- Pricing: Current price, currency, optional previous price and unit price.\n  Examples: €49.95 (was €64.95), $24.99 | $12.50/plug\n- Availability / Stock Status: Stock state and sometimes shipping lead time or scarcity message.\n  Examples: In stock — ships in 1–2 business days, Only 3 left in stock\n- Ratings & Social Proof: Average star rating, review count, or Q&A count.\n  Examples: 4.4/5 (128 reviews), 25 answered questions\n- Category Path: Hierarchical breadcrumb taxonomy from department to leaf category.\n  Examples: Outdoor > Camping > Sleeping Bags, Home > Lighting > Smart Bulbs\n- Short Description: One-sentence tagline summarizing the product's main benefit.\n  Examples: Lightweight daypack with a ventilated back panel.\n\n**Relations:**\n- made by → Brand\n\n**Examples:**\n- Trailblaze 28L Hiking Backpack\n- Aurora Smart LED Bulb 4-pack\n\n### Brand\nManufacturer or seller brand identity shown near the title.\n\n**Examples:**\n- Peakline Gear\n- Voltaro\n\n### Pricing\nCurrent price, currency, optional previous price and unit price.\n\n**Examples:**\n- €49.95 (was €64.95)\n- $24.99 | $12.50/plug\n\n### Features List\nBulleted marketing-oriented list of 3–6 selling points.\n\n**Relations:**\n- section of → Product Listing\n\n**Examples:**\n- Hydration-compatible\n- No hub required — Wi-Fi 2.4 GHz\n\n### Specifications\nCompact key–value technical data block.\n\n**Relations:**\n- section of → Product Listing\n\n**Examples:**\n- Weight: 920 g\n- Lifespan 25,000 hours\n\n### Variants / Options\nAlternative colours, sizes or pack counts, possibly with individual prices.\n\n**Relations:**\n- offers → Product Listing\n- each has price → Pricing\n\n**Examples:**\n- 1-pack ($12.99), 2-pack ($22.99)\n- Forest Green, Slate Grey\n\n### Shipping & Returns Policy\nFree-shipping thresholds, return window and conditions.\n\n**Relations:**\n- policy for → Product Listing\n\n**Examples:**\n- Free shipping over €50; 30-day free returns\n\n## Dimensions\n\n### Currency / Market Locale\nRegion determining currency, units, and formatting.\n\n### Product Category Domain\nBroad product domain that determines features and specs.\n\n### Layout Style\nFormatting of the listing: pipe-separated header lines, bullets (- or *), labelled sections.\n\n### Price Tier\nPositioning from budget to premium.\n\n## Constraints\n\n- **Internal Consistency** (Pricing, Variants / Options): Price, unit price and variant prices must reconcile; pack size matches title; specs match category.\n- **Concise Telegraphic Style** (Features List): Short fragments, units always included, no long prose, typically under 200 words.\n- **Identifier Format Rules** (Product Identifiers): SKUs are uppercase hyphenated codes; GTINs are 13 digits; fictional brands only.\n- **Category-Appropriate Fields** (Product Listing): Only include sections relevant to the product type (care for textiles, voltage for electronics)."}}