{"title":"ProductRichData - Liquid Object Reference","slug":"product-rich-data-liquid-object-reference","url":"https://support.storeconnect.com/articles/product-rich-data-liquid-object-reference","url_markdown":"https://support.storeconnect.com/articles/product-rich-data-liquid-object-reference.md","subtitle":null,"summary":"Look up the ProductRichData attributes (warranty, rating, color, material, size, pattern, shipping, and return policy values) that feed a product\u0026#39;s schema.org structured data, reached through product.rich_data.","type":"Developer_Documentation","video_url":"","keywords":"liquid, objects, ProductRichData, rich data, structured data, product, template, storeconnect","last_modified":"2026-10-29T22:26:04+0000","body_markdown":"## Description\n\nThe ProductRichData object holds the Product values that StoreConnect publishes as schema.org structured data on product pages. Reach it through `product.rich_data`, for example `{{ product.rich_data.color }}`. Each attribute reads the Product field of the same name, so a blank field returns blank.\n\nThe fifteen fields added for structured data are available only here. The older fields it also covers (`condition`, `upc`, and the shipping weight, dimensions, and their units) are on the [Product](product-liquid-object-reference) object as well.\n\n## Attributes\n\n| Attribute | Type | Description |\n|-----------|------|-------------|\n| `best_rating` | Number | Returns the top of the rating scale for the Product's reviews; blank means 5 in structured data |\n| `color` | String | Returns the Product's color, kept in step with a Color trait when it has one |\n| `condition` | String | Returns the value of the Condition attribute |\n| `material` | String | Returns the Product's material, kept in step with a Material trait when it has one |\n| `pattern` | String | Returns the Product's pattern, kept in step with a Pattern trait when it has one |\n| `rating_value` | Number | Returns the Product's aggregate review rating |\n| `restocking_fee` | Number | Returns the fee charged when the Product is returned, in the Store's currency |\n| `return_policy_category` | String | Returns the schema.org return policy category for the Product, for example `MerchantReturnFiniteReturnWindow` |\n| `return_policy_country` | String | Returns the two-letter ISO 3166-1 country the Product's return policy applies to |\n| `return_window_days` | Number | Returns the number of days the Product can be returned within |\n| `review_count` | Number | Returns the number of reviews behind the Product's rating |\n| `shipping_charges` | String | Returns how shipping is charged for the Product in structured data: `Free`, `Billed`, or blank |\n| `shipping_cost` | Number | Returns the flat shipping cost published for the Product in structured data |\n| `shipping_dimensions_unit` | String | Returns the unit of measure for the Product's shipping dimensions |\n| `shipping_height` | Number | Returns the Product's shipping height |\n| `shipping_length` | Number | Returns the Product's shipping length |\n| `shipping_weight` | Number | Returns the Product's shipping weight |\n| `shipping_weight_unit` | String | Returns the unit of measure for the Product's shipping weight |\n| `shipping_width` | Number | Returns the Product's shipping width |\n| `size` | String | Returns the Product's size, kept in step with a Size trait when it has one |\n| `upc` | String | Returns the value of the UPC attribute |\n| `warranty_duration` | Number | Returns the length of the Product's warranty, in `warranty_unit` units |\n| `warranty_unit` | String | Returns the UN/CEFACT unit code of `warranty_duration`, for example `MON` or `ANN` |\n\n## Example\n\nThis example shows a product's color and size only when they are set:\n\n\n```liquid\n\n{% if product.rich_data.color != blank %}\n  \u003cp\u003eColor: {{ product.rich_data.color }}\u003c/p\u003e\n{% endif %}\n{% if product.rich_data.size != blank %}\n  \u003cp\u003eSize: {{ product.rich_data.size }}\u003c/p\u003e\n{% endif %}\n```\n\n\n## Available on\n\n- [Product - Liquid Object Reference](product-liquid-object-reference) — `rich_data`"}