Product Material Composition Schema for AI Shopping Agents

Why Material Data Is an AI Shopping Filter

Material composition is one of the most common product filters in shopping queries. Unlike price or color, material requirements are often exclusionary — a buyer looking for "no synthetic fibers" or "latex-free gloves" needs the AI agent to positively confirm the absence of a material, not just find products with a matching word in the description.

The three failure modes without structured material data:

1. False positives: AI agent recommends a "natural linen" product that's 45% polyester because the description mentions linen prominently
2. False negatives: AI agent excludes a 100% organic cotton product from "no-pesticide fabric" results because the GOTS certification isn't machine-readable
3. Compliance misses: AI procurement agent recommends a product for EU sale without surfacing that it lacks REACH documentation

Query types that require structured material data

Core Material Composition JSON-LD Patterns

Simple single-material product

For products made from a single material, the schema.org material property on the Product type is sufficient:

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Classic White Oxford Shirt",
  "material": "100% Egyptian Cotton",
  "additionalProperty": [
    {
      "@type": "PropertyValue",
      "propertyID": "fabricWeight",
      "name": "Fabric Weight",
      "value": "120 gsm"
    }
  ]
}

Multi-material composition with percentages

For blended materials, use additionalProperty to declare each component with its percentage. This enables the exclusion queries that single material strings cannot serve:

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Performance Athletic Tee",
  "material": "65% Polyester, 35% Organic Cotton",
  "additionalProperty": [
    {
      "@type": "PropertyValue",
      "propertyID": "materialComposition",
      "name": "Polyester Content",
      "value": "65%",
      "unitText": "percent",
      "valueReference": {
        "@type": "PropertyValue",
        "name": "Material",
        "value": "Recycled Polyester"
      }
    },
    {
      "@type": "PropertyValue",
      "propertyID": "materialComposition",
      "name": "Cotton Content",
      "value": "35%",
      "unitText": "percent",
      "valueReference": {
        "@type": "PropertyValue",
        "name": "Material",
        "value": "GOTS Certified Organic Cotton"
      }
    }
  ]
}

Chemical safety and compliance signals

Chemical compliance declarations use additionalProperty with standardized propertyID values. Use these alongside the materialSafety property (schema.org v24+) for maximum agent coverage:

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Food Storage Container Set — 4-piece",
  "material": "Borosilicate Glass, Silicone",
  "additionalProperty": [
    {
      "@type": "PropertyValue",
      "propertyID": "reachCompliant",
      "name": "REACH Compliance",
      "value": "SVHC-free per Candidate List v29 (January 2026)"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "materialSafety",
      "name": "BPA Status",
      "value": "BPA-free — no bisphenol A in any component"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "materialSafety",
      "name": "Phthalate Status",
      "value": "Phthalate-free — silicone lid contains no DEHP, DBP, BBP, or DIBP"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "foodContact",
      "name": "Food Contact Safety",
      "value": "FDA 21 CFR 177.2315 compliant — safe for direct food contact"
    }
  ]
}

TSCA compliance for US products

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Industrial Solvent Cleaner — 1L",
  "additionalProperty": [
    {
      "@type": "PropertyValue",
      "propertyID": "tscaCompliant",
      "name": "TSCA Compliance",
      "value": "Compliant with TSCA Section 6 restrictions; no PBT chemicals. SDS available on request."
    },
    {
      "@type": "PropertyValue",
      "propertyID": "prop65Warning",
      "name": "California Prop 65 Warning",
      "value": "WARNING: This product contains chemicals known to the State of California to cause cancer. For more information: www.P65Warnings.ca.gov"
    }
  ]
}

Organic certification using hasCertification

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Organic Crib Sheet — White",
  "material": "100% Organic Cotton",
  "hasCertification": {
    "@type": "Certification",
    "certificationIdentification": "GOTS",
    "name": "Global Organic Textile Standard",
    "issuedBy": {
      "@type": "Organization",
      "name": "Control Union Certifications"
    },
    "certificationStatus": "ActiveCertification",
    "validUntil": "2027-03-31"
  },
  "additionalProperty": [
    {
      "@type": "PropertyValue",
      "propertyID": "organicCertification",
      "name": "Organic Certification",
      "value": "GOTS Certified Organic — cert. #CU123456"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "pesticideFree",
      "name": "Pesticide Status",
      "value": "Certified pesticide-free per GOTS standard"
    }
  ]
}

Shopify Liquid Implementation

Material composition data rarely changes after product creation, so metafields are the right storage mechanism. Use a materials namespace with fields for the simple string and a JSON composition breakdown.

Metafield setup

Liquid snippet for product.liquid

{% assign mats = product.metafields.materials %}
{% if mats.primary != blank %}
"material": {{ mats.primary | json }},
{% endif %}
"additionalProperty": [
  {% if mats.reach_compliant == true %}
  {
    "@type": "PropertyValue",
    "propertyID": "reachCompliant",
    "name": "REACH Compliance",
    "value": "SVHC-free per current Candidate List"
  },
  {% endif %}
  {% if mats.bpa_free == true %}
  {
    "@type": "PropertyValue",
    "propertyID": "materialSafety",
    "name": "BPA Status",
    "value": "BPA-free"
  },
  {% endif %}
  {% if mats.organic_cert != blank %}
  {
    "@type": "PropertyValue",
    "propertyID": "organicCertification",
    "name": "Organic Certification",
    "value": {{ mats.organic_cert | json }}
  },
  {% endif %}
  {% if mats.prop65_warning != blank %}
  {
    "@type": "PropertyValue",
    "propertyID": "prop65Warning",
    "name": "California Prop 65 Warning",
    "value": {{ mats.prop65_warning | json }}
  },
  {% endif %}
  {% if mats.composition_json != blank %}
    {% assign comp = mats.composition_json | parse_json %}
    {% for c in comp %}
    {
      "@type": "PropertyValue",
      "propertyID": "materialComposition",
      "name": {{ c.name | json }},
      "value": {{ c.pct | append: '%' | json }}
    }{% unless forloop.last %},{% endunless %}
    {% endfor %}
  {% endif %}
]

Compliance Declaration Reference

Implementation Checklist

• Add material property to all products with a primary material string
• Add materialComposition additionalProperty array for multi-material products with percentages
• For chemical safety claims (BPA-free, phthalate-free): add materialSafety additionalProperty
• For REACH compliance: add reachCompliant additionalProperty with Candidate List version
• For TSCA compliance: add tscaCompliant additionalProperty
• For California Prop 65: add prop65Warning additionalProperty with full required warning text
• For organic products: use hasCertification with Certification type + organicCertification fallback
• Store compliance flags in metafields for catalog-wide management
• Keep REACH/TSCA documentation current — the structured data declaration references your actual compliance records
• Ping IndexNow after adding material markup to existing products

Related Resources

• Country-of-Origin & Provenance Schema for AI Shopping Agents
• Product Safety Certifications JSON-LD for AI Shopping Agents
• Product Recalls & Safety Notices Structured Data for Shopify