Ecommerce Product Condition Structured Data

The schema.org OfferItemCondition Enum

Implementing itemCondition in Shopify JSON-LD

Basic condition from product tag or metafield

Shopify doesn't have a native condition field. The two common approaches are a product tag ("condition:new", "condition:refurbished") or a metafield (product.metafields.custom.condition). Both work well in Liquid:

{%- comment -%}
  Approach 1: Use a product tag in format "condition:value"
  Tag examples: "condition:new", "condition:refurbished", "condition:used"
{%- endcomment -%}
{%- assign condition_url = 'https://schema.org/NewCondition' -%}
{%- for tag in product.tags -%}
  {%- if tag contains 'condition:' -%}
    {%- assign condition_val = tag | remove: 'condition:' | strip | downcase -%}
    {%- if condition_val == 'refurbished' -%}
      {%- assign condition_url = 'https://schema.org/RefurbishedCondition' -%}
    {%- elsif condition_val == 'used' -%}
      {%- assign condition_url = 'https://schema.org/UsedCondition' -%}
    {%- elsif condition_val == 'damaged' -%}
      {%- assign condition_url = 'https://schema.org/DamagedCondition' -%}
    {%- elsif condition_val == 'old' or condition_val == 'vintage' -%}
      {%- assign condition_url = 'https://schema.org/OldCondition' -%}
    {%- endif -%}
    {%- break -%}
  {%- endif -%}
{%- endfor -%}

"itemCondition": {{ condition_url | json }}

Approach 2: Metafield-based condition

{%- comment -%}
  Create a metafield: product.metafields.custom.condition
  with values: "new", "refurbished", "used", "damaged", "vintage"
{%- endcomment -%}
{%- assign condition_meta = product.metafields.custom.condition | downcase -%}
{%- case condition_meta -%}
  {%- when 'refurbished' -%}{%- assign condition_url = 'https://schema.org/RefurbishedCondition' -%}
  {%- when 'used' -%}{%- assign condition_url = 'https://schema.org/UsedCondition' -%}
  {%- when 'damaged' -%}{%- assign condition_url = 'https://schema.org/DamagedCondition' -%}
  {%- when 'vintage', 'old' -%}{%- assign condition_url = 'https://schema.org/OldCondition' -%}
  {%- else -%}{%- assign condition_url = 'https://schema.org/NewCondition' -%}
{%- endcase -%}

"itemCondition": {{ condition_url | json }}

Multi-Condition Catalogs

Stores selling both new and refurbished versions of the same product should create separate Offer blocks — one per condition — rather than using a single Offer with a condition that describes both:

"offers": [
  {
    "@type": "Offer",
    "name": "New",
    "price": "{{ new_price }}",
    "priceCurrency": "USD",
    "itemCondition": "https://schema.org/NewCondition",
    "availability": "https://schema.org/InStock"
  },
  {
    "@type": "Offer",
    "name": "Certified Refurbished",
    "price": "{{ refurb_price }}",
    "priceCurrency": "USD",
    "itemCondition": "https://schema.org/RefurbishedCondition",
    "availability": "https://schema.org/InStock",
    "description": "Professionally refurbished. 90-day warranty included."
  }
]

This dual-offer pattern lets AI agents recommend the appropriate tier: a "refurbished DSLR" query recommends the RefurbishedCondition Offer, while a "new DSLR" query recommends the NewCondition Offer — from the same product page.

Condition-Specific Description Patterns

AI agents extract condition context from both the structured itemCondition value and the surrounding Offer and product description text. For maximum coverage, include explicit condition language in description fields:

Condition and Return Policy Interaction

AI agents correlate product condition with return policy signals. Refurbished products with no return policy are surfaced less confidently by ChatGPT Shopping and Perplexity Shopping than refurbished products with explicit warranty or return terms. The interaction:

Product Condition Structured Data Checklist

Related Resources

• Shopify Schema Markup Guide — full Offer block reference including all OfferItemCondition values and Liquid snippets.
• Ecommerce Return Policy Structured Data — MerchantReturnPolicy implementation for refurbished and used product warranties.
• Shopify Product Availability Structured Data — availability signals that interact with condition for refurbished catalog pages.
• AI Shopping Agent Product Ranking Factors — how itemCondition factors into the 18 catalog signals scored by CatalogScan.

Frequently Asked Questions

Audit Product Condition Across Your Catalog

CatalogScan checks every Offer block for missing or incorrect itemCondition values — including refurbished products incorrectly labeled as NewCondition and used products with no condition signal at all.