--- title: "ProductRichData - Liquid Object Reference" source: https://support.storeconnect.com/articles/product-rich-data-liquid-object-reference type: article format: markdown site: StoreConnect Support — product and developer documentation for StoreConnect site_index: https://storeconnect.com/llms.txt docs_index: https://support.storeconnect.com/llms.txt note: Append .md to any page or article URL on this site to get its Markdown form. --- # ProductRichData - Liquid Object Reference ## Description The 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. The 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. ## Attributes | Attribute | Type | Description | |-----------|------|-------------| | `best_rating` | Number | Returns the top of the rating scale for the Product's reviews; blank means 5 in structured data | | `color` | String | Returns the Product's color, kept in step with a Color trait when it has one | | `condition` | String | Returns the value of the Condition attribute | | `material` | String | Returns the Product's material, kept in step with a Material trait when it has one | | `pattern` | String | Returns the Product's pattern, kept in step with a Pattern trait when it has one | | `rating_value` | Number | Returns the Product's aggregate review rating | | `restocking_fee` | Number | Returns the fee charged when the Product is returned, in the Store's currency | | `return_policy_category` | String | Returns the schema.org return policy category for the Product, for example `MerchantReturnFiniteReturnWindow` | | `return_policy_country` | String | Returns the two-letter ISO 3166-1 country the Product's return policy applies to | | `return_window_days` | Number | Returns the number of days the Product can be returned within | | `review_count` | Number | Returns the number of reviews behind the Product's rating | | `shipping_charges` | String | Returns how shipping is charged for the Product in structured data: `Free`, `Billed`, or blank | | `shipping_cost` | Number | Returns the flat shipping cost published for the Product in structured data | | `shipping_dimensions_unit` | String | Returns the unit of measure for the Product's shipping dimensions | | `shipping_height` | Number | Returns the Product's shipping height | | `shipping_length` | Number | Returns the Product's shipping length | | `shipping_weight` | Number | Returns the Product's shipping weight | | `shipping_weight_unit` | String | Returns the unit of measure for the Product's shipping weight | | `shipping_width` | Number | Returns the Product's shipping width | | `size` | String | Returns the Product's size, kept in step with a Size trait when it has one | | `upc` | String | Returns the value of the UPC attribute | | `warranty_duration` | Number | Returns the length of the Product's warranty, in `warranty_unit` units | | `warranty_unit` | String | Returns the UN/CEFACT unit code of `warranty_duration`, for example `MON` or `ANN` | ## Example This example shows a product's color and size only when they are set: ```liquid {% if product.rich_data.color != blank %}

Color: {{ product.rich_data.color }}

{% endif %} {% if product.rich_data.size != blank %}

Size: {{ product.rich_data.size }}

{% endif %} ``` ## Available on - [Product - Liquid Object Reference](product-liquid-object-reference) — `rich_data` --- ## Follow StoreConnect - [Email Newsletter](https://storeconnect.com/c/lp-newsletter) - [LinkedIn Newsletter](https://www.linkedin.com/build-relation/newsletter-follow?entityUrn=7444956928444862464) - [YouTube](https://www.youtube.com/channel/UCngKdP2x8l1wcbAKW3tvU8g) - [LinkedIn](https://www.linkedin.com/company/storeconnect) - [X / Twitter](https://x.com/storeconnecthq) ## Popular Links - [Partners](https://storeconnect.com/partners) - [Become a Partner](https://storeconnect.com/become-a-partner) - [News](https://storeconnect.com/articles/news) - [Events](https://storeconnect.com/articles/events) - [Feature Comparison](https://storeconnect.com/how-we-compare) - [Download a free trial](https://appexchange.salesforce.com/appxListingDetail?listingId=a0N3A00000FMkeKUAT) - [Book a Demo](https://storeconnect.com/contact) ## Documentation - [Help documentation](https://support.storeconnect.com/help-documentation) - [AI agents](https://support.storeconnect.com/ai) - [Videos & tutorials](https://support.storeconnect.com/videos-tutorials) - [Developer reference](https://support.storeconnect.com/developer-reference) - [Release notes](https://support.storeconnect.com/release-notes) - [Troubleshooting](https://support.storeconnect.com/troubleshooting) - [Trust Center](https://trust.getstoreconnect.com/) - [Status Page](https://status.storeconnect.com/) ## Contact - info@getstoreconnect.com - US +1 415 745 3230 - AUS +61 2 8365 2308 100 S Ashley Dr, Suite 600-2461 Tampa FL 33602-600 USA Level 22, Sydney Place 180 George Street Sydney, NSW, 2000, AUS ## Machine-readable - [Site index for agents](https://storeconnect.com/llms.txt): curated map of the StoreConnect site in llms.txt format - [Documentation index for agents](https://support.storeconnect.com/llms.txt): full technical and product documentation map Every page and article on this site has a Markdown rendering: append `.md` to its URL. Continue in Markdown: [Help documentation](https://support.storeconnect.com/help-documentation.md) · [Developer reference](https://support.storeconnect.com/developer-reference.md) · [Videos & tutorials](https://support.storeconnect.com/videos-tutorials.md) · [Release notes](https://support.storeconnect.com/release-notes.md) --- StoreConnect Support — https://support.storeconnect.com/articles/product-rich-data-liquid-object-reference