--- title: "Product Schema · Unhead" canonical_url: "https://unhead.unjs.io/docs/svelte/schema-org/api/schema/product" last_updated: "2026-09-11T01:46:17.359Z" meta: description: "Use defineProduct() to add Product structured data for e-commerce pages with pricing, reviews, and availability." "og:description": "Use defineProduct() to add Product structured data for e-commerce pages with pricing, reviews, and availability." "og:title": "Product Schema · Unhead" --- Home ` Unhead on GitHub Switch to SvelteSwitch to TypeScriptSwitch to VueSwitch to ReactSwitch to Solid.jsSwitch to AngularSwitch to Nuxt **Schema** # **Product Schema** [Copy for LLMs](https://raw.githubusercontent.com/unjs/unhead/refs/heads/main/docs/schema-org/5.api/9.schema/product.md) ## Schema.org Product - **Type**: `defineProduct>(input?: Product & T)` Describes a Product on a WebPage. ## Useful Links - [**~~Product - Schema.org~~**](https://schema.org/Product) - [**~~Product Schema Markup - Google Search Central~~**](https://developers.google.com/search/docs/appearance/structured-data/product) - [**~~Merchant Listing Markup - Google Search Central~~**](https://developers.google.com/search/docs/appearance/structured-data/merchant-listing) - [**~~Product Variant Markup - Google Search Central~~**](https://developers.google.com/search/docs/appearance/structured-data/product-variants) - [**~~Recipe: E-commerce~~**](https://unhead.unjs.io/docs/schema-org/guides/recipes/e-commerce) For a Google product snippet, `**name**` and at least one of `**review**`, `**aggregateRating**`, or `**offers**` are required. Google supports product rich results on pages focused on one product or variants of that product; see the [**~~product snippet requirements~~**](https://developers.google.com/search/docs/appearance/structured-data/product-snippet#structured-data-type-definitions). ## Unhead input properties The `**Product**` TypeScript interface requires `**name**` and `**image**` when you pass an object. `**defineProduct()**` itself accepts no argument, and the resolver can inherit both values from page metadata. Unhead does not check Google's eligibility requirements at runtime. - **name** `**string**` Provide the product name through the `**title**` route metadata or set `**name**` explicitly. - **image** `**NodeRelations**` Link a primary image or a collection of images to the product. ## Recommended Properties - **offers** `**NodeRelations**` Add [**~~Offer~~**](https://schema.org/Offer) properties. Google's merchant and product variant documentation also uses `**audience**`, `**category**`, `**color**`, GTIN variants, `**hasAdultConsideration**`, `**hasCertification**`, `**inProductGroupWithID**`, `**isVariantOf**`, `**material**`, `**pattern**`, `**size**`, and `**subjectOf**`. Unhead types their nested CategoryCode, Certification, PeopleAudience, ProductGroup, SizeSpecification, and 3DModel values. Offer price specifications cover active prices, struck-through prices, unit pricing, member prices, and loyalty points. The type prevents `**priceType**` and `**validForMemberTier**` from appearing together. ## Defaults - **@type**: `**Product**` - **@id**: `**${canonicalUrl}#product**` - **name**: page title from resolved metadata - **image**: resolved page image - **description**: resolved page description - **brand**: id reference of the identity - **mainEntityOfPage**: ID reference of the WebPage ## Resolves See [**~~Global Resolves~~**](https://unhead.unjs.io/docs/schema-org/guides/get-started/overview#how-does-schemaorg-get-page-data) for full context. - when `**image**` is a single string, it is resolved to a root ImageObject node with an absolute URL; arrays are left as the supplied image values - `**audience**`, `**brand**`, `**hasCertification**`, `**isVariantOf**`, and `**subjectOf**` resolve as typed nested nodes - untyped `**brand**` objects resolve as `**Brand**`; set `**@type: Organization**` for an organization brand ## Examples ### Minimal Example ``` defineProduct({ name: 'Guide To Vue.js', image: '/vuejs-book.png', }) ``` ### Product with an offer, rating, and review ``` defineProduct({ name: 'Ergonomic Desk Chair', image: '/product.png', offers: [ { price: 50 }, ], aggregateRating: { ratingValue: 88, bestRating: 100, ratingCount: 20, }, review: [ { name: 'Comfortable and easy to assemble.', author: { name: 'Harlan Wilton', }, reviewRating: { ratingValue: 5, }, }, ], }) ``` ## Types ``` /** * Any offered product or service. * For example: a pair of shoes; a concert ticket; the rental of a car; * a haircut; or an episode of a TV show streamed online. */ export interface ProductSimple extends Thing { /** * The name of the product. */ name: string /** * A reference-by-ID to one or more ImageObjects which represent the product. * Google eligibility has separate image guidelines; see the Product guide above. */ image: NodeRelations /** * An array of references-by-ID to one or more Offer or aggregateOffer pieces. */ offers?: NodeRelations /** * A Brand or Organization associated with the Product. */ brand?: NodeRelation /** * A reference to an Organization piece which represents the seller/merchant. */ seller?: NodeRelation /** * A text description of the product. */ description?: string /** * An array of references-by-id to one or more Review pieces. */ review?: NodeRelations /** * A merchant-specific identifier for the Product. */ sku?: string /** * The Global Trade Item Number (GTIN) of the product. */ gtin?: string /** * The Manufacturer Part Number (MPN) of the product. */ mpn?: string /** * The condition of the product (e.g., New, Used, Refurbished). */ itemCondition?: string /** * An AggregateRating object. */ aggregateRating?: NodeRelation /** * An AggregateOffer object. */ aggregateOffer?: NodeRelation /** * A reference to an Organization piece, representing the brand which produces the Product. */ manufacturer?: NodeRelation audience?: NodeRelations category?: Arrayable | string> color?: Arrayable gtin8?: string gtin12?: string gtin13?: string gtin14?: string isbn?: string hasAdultConsideration?: Arrayable hasCertification?: NodeRelations inProductGroupWithID?: string isVariantOf?: NodeRelation material?: Arrayable pattern?: Arrayable size?: NodeRelation subjectOf?: NodeRelation } ``` ## Related Schemas - [**~~Organization~~**](https://unhead.unjs.io/docs/schema-org/api/schema/organization): Product brand/manufacturer - [**~~Breadcrumb~~**](https://unhead.unjs.io/docs/schema-org/api/schema/breadcrumb): Product navigation - [**~~ItemList~~**](https://unhead.unjs.io/docs/schema-org/api/schema/item-list): Product lists [Edit this page](https://github.com/unjs/unhead/edit/main/docs/schema-org/5.api/9.schema/product.md) [Markdown For LLMs](https://raw.githubusercontent.com/unjs/unhead/refs/heads/main/docs/schema-org/5.api/9.schema/product.md) **Did this page help you? ** [**Podcast Series Schema** Use definePodcastSeries() to describe a podcast show, including its host, RSS feed, episodes, seasons, dates, and cover image.](https://unhead.unjs.io/docs/schema-org/api/schema/podcast-series) [**Question Schema** Use defineQuestion() to add Question and Answer structured data and connect FAQPage mainEntity references.](https://unhead.unjs.io/docs/schema-org/api/schema/question) **On this page ** - [Schema.org Product](#schemaorg-product) - [Useful Links](#useful-links) - [Unhead input properties](#unhead-input-properties) - [Recommended Properties](#recommended-properties) - [Defaults](#defaults) - [Resolves](#resolves) - [Examples](#examples) - [Types](#types) - [Related Schemas](#related-schemas)