Optimization Guide
Shopify Fashion Sustainability Schema — Recycled Content, GRS Certification, Bluesign, Carbon Footprint Structured Data
AI shopping agents handling queries like "recycled polyester jacket GRS certified no virgin plastic," "organic cotton t-shirt GOTS certified carbon neutral," "Bluesign approved denim jeans PFC-free DWR," "sustainable swimwear recycled ocean plastic 100% recycled ECONYL," or "fashion brand with verified carbon offset and take-back program" need machine-readable recycled content percentages, certification body verifications, carbon footprint data, and supply chain transparency markers. Shopify's default JSON-LD outputs nothing about what percentage of a garment is recycled, whether that recycled content claim is GRS-verified by a third party, or what the product's cradle-to-gate carbon footprint is — the sustainability claims that are the primary purchase filter for a growing segment of fashion buyers are entirely invisible to AI shopping agents.
Product @type with sustainabilityFeature (natural language strings for NLP) alongside additionalProperty for machine-readable values: recycledContentPct (% by weight, GRS-verified), primaryFiberContent (e.g., "68% recycled polyester, 22% organic cotton, 10% elastane"), carbonFootprintKgCO2e (per garment, cradle-to-gate), waterUsageLiters (per garment production), dyeProcess (controlled vocabulary), pfcFree boolean, takeBackProgram boolean. Add hasCertification for GRS, GOTS, Bluesign, OEKO-TEX Made in Green, Fair Trade Certified, B Corp, Cradle to Cradle, Leather Working Group. Use Organization sameAs to link brand's sustainability report URL. Store in sustain.* metafield namespace.
Why Fashion Sustainability Claims Are Structurally Invisible to AI Agents
Sustainable fashion is a category where the primary purchase differentiator — the certification pedigree and measurable impact of a sustainability claim — cannot be encoded by Shopify's default schema output at all. A product titled "Recycled Fleece Jacket" and another titled "Eco Fleece Jacket" are indistinguishable to an AI agent without structured data encoding what "recycled" means quantitatively, who verified it, and what the downstream impact is.
The certification hierarchy — not all "sustainable" claims are equal
There is a dramatic difference in verification rigor between a brand self-declaring "sustainable" (no third-party verification), a product carrying OEKO-TEX Standard 100 (tests finished products for harmful substances — does not certify environmental impact or recycled content), GRS (Global Recycled Standard — verifies recycled content percentage by weight via third-party chain of custody from recycler through manufacturer), GOTS (Global Organic Textile Standard — the most rigorous broad standard: certified organic fiber plus ecological processing plus full ILO social standards across the entire supply chain), and Bluesign (chemistry management and resource efficiency in dyeing and finishing — the most rigorous standard for process sustainability in wet processing). AI agents must distinguish these or all sustainability queries collapse to the same result: "has sustainability claims."
Recycled content percentage and GRS verification are separate dimensions
A product can claim "made with recycled materials" and contain 5% recycled content — legally defensible in most jurisdictions. GRS certification requires a minimum of 20% recycled content for blended products labeled as containing recycled material, and 95% minimum recycled content for products labeled as "recycled" without qualification, with full third-party chain-of-custody verification from the original recycler through each stage of manufacturing to the finished product. Without encoding both the percentage AND whether it is GRS-certified by an independent body, an AI agent cannot distinguish 100% GRS-certified recycled polyester from a product using 5% recycled filler to claim "sustainable." The percentage and the certification are separate data points that must both appear in structured data.
Carbon footprint per garment — the emerging filterable metric
Scope 1+2+3 carbon footprint per garment, expressed in kg CO2e on a cradle-to-gate basis, is becoming the new purchase filter in the sustainable fashion segment. Brands including Patagonia, Allbirds, and Pangaia have started publishing per-product carbon footprints backed by lifecycle assessment data. Schema.org does not have a standard carbonFootprint property as of 2026 — encode via additionalProperty with name "Carbon Footprint" and value in kg CO2e, with a description specifying the methodology (Higg MSI-based, EPD ISO 14025, or PEF EU methodology) and the scope boundary (cradle-to-gate vs cradle-to-grave). AI agents handling queries like "lowest carbon footprint fleece hoodie under 5 kg CO2e GRS certified" need this data as a typed numeric value in structured data, not embedded in a marketing paragraph.
PFC-free DWR is a binary purchase filter for outdoor and rainwear
Per- and polyfluoroalkyl substances (PFAS, also called PFCs) have been used in durable water repellent (DWR) coatings on outdoor jackets, hiking pants, and rainwear for decades due to their exceptional water-repellency performance. PFCs are persistent environmental contaminants — they do not break down in the environment or in human tissue, earning the name "forever chemicals." The EU restricted long-chain PFCs (C8 and C6 compounds) in textiles under REACH Annex XVII in 2023, and leading outdoor brands including Patagonia, Arc'teryx, and The North Face have switched to PFC-free DWR alternatives using C0 (zero-fluorocarbon) technology. Buyers filtering for "PFAS-free outdoor jacket" need the pfcFree boolean in additionalProperty — not "eco-friendly" buried in the product title or description text.
Take-back programs as a structured property
A brand's garment take-back or repair program is increasingly a factor in purchase decisions: it reduces the buyer's landfill guilt at end-of-garment-life and signals that the brand stands behind the product's durability. Schema.org's potentialAction can encode a ReturnAction or RepairAction linking directly to the take-back program URL. AI agents advising eco-conscious buyers comparing two otherwise-similar jackets need take-back program availability as structured data — not three pages deep in a brand's About Us section.
Fashion sustainability certification comparison
| Certification | Issuing body | What it certifies | Recycled content? | Social standards? | Chain of custody |
|---|---|---|---|---|---|
| GRS (Global Recycled Standard) | Textile Exchange | Recycled content % by weight, supply chain traceability | Yes — verified % (20%+ blended, 95%+ pure recycled) | Basic (no forced/child labor) | Full chain from recycler to brand |
| GOTS (Global Organic Textile Standard) | GOTS Association | Organic fiber (70%+ certified organic) + ecological processing + social standards | No (organic fiber, not recycled) | Full ILO standards | Full from farm to finished product |
| Bluesign | bluesign technologies ag | Chemical management, resource efficiency in dyeing/finishing | No (process, not fiber content) | Partial | Facility-level (not full supply chain) |
| OEKO-TEX Standard 100 | OEKO-TEX | Absence of harmful substances in finished product | No (harmful substances only) | No | Product-level testing only |
| OEKO-TEX Made in Green | OEKO-TEX | OEKO-TEX 100 + responsible production (environmental + social audit) | No | Basic social audit | Facility traceability label |
| Fair Trade Certified (apparel) | Fair Trade USA | Fair wages, safe conditions for garment workers | No (social only) | Full — fair wage premium | Factory-level |
| B Corp Certification | B Lab | Overall company environmental + social performance | No (company-wide) | Yes (stakeholder model) | Company-level |
| Cradle to Cradle | Cradle to Cradle Products Innovation Institute | Material health, circularity, renewable energy, water, social | Partially (material circularity) | Yes | Product-level, 5-category scoring |
Complete Sustainable Jacket Schema — Recycled Fleece Example
The following is a complete JSON-LD Product schema for a 100% recycled polyester fleece jacket with GRS certification, Bluesign approved fabric, and PFC-free DWR. This represents the full structured data output a sustainability-forward Shopify store should produce.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Recycled Fleece Pullover Hoodie — 100% GRS Certified Recycled Polyester",
"description": "Full-zip fleece hoodie made from 100% recycled polyester (post-consumer PET bottles), GRS certified by Textile Exchange. Bluesign approved fabric dyeing and finishing. PFC-free DWR coating (C0 technology). Carbon footprint: 4.2 kg CO2e per garment (cradle-to-gate, Higg MSI). Take-back program: return any brand garment at end of life.",
"sku": "RF-HOODIE-001",
"brand": { "@type": "Brand", "name": "Example Sustainable Brand" },
"sustainabilityFeature": [
"Made from 100% recycled polyester certified by the Global Recycled Standard (GRS) — no virgin plastic",
"PFC-free — no per- and polyfluoroalkyl substances in fabric or DWR coating",
"Carbon footprint: 4.2 kg CO2e per jacket (cradle-to-gate, Higg MSI methodology)",
"Take-back program: return any brand jacket at end of life for closed-loop recycling",
"Bluesign approved fabric — dyeing and finishing verified for chemical management and water efficiency"
],
"hasCertification": [
{
"@type": "Certification",
"name": "Global Recycled Standard (GRS)",
"issuedBy": {
"@type": "Organization",
"name": "Textile Exchange",
"url": "https://textileexchange.org"
},
"certificationIdentification": "GRS-2026-XXXXXX",
"description": "GRS certification verifies 100% recycled polyester content by weight (post-consumer PET bottles). Third-party chain-of-custody verification from PET recycler through yarn spinner through fabric mill to finished garment. Certifying body: Textile Exchange. Certificate scope: 95%+ recycled content threshold for pure recycled labeling. Includes basic social criteria: no forced labor, no child labor."
},
{
"@type": "Certification",
"name": "Bluesign Approved",
"issuedBy": {
"@type": "Organization",
"name": "bluesign technologies ag",
"url": "https://www.bluesign.com"
},
"description": "Bluesign approval covers the dyeing and finishing process at the fabric mill. Certifies: restricted substances list (RSL) compliance beyond REACH, optimized water consumption and wastewater treatment, reduced energy use in dyeing and finishing, worker health and safety at dyeing facility. Bluesign does not certify fiber content or social standards in cut-and-sew manufacturing."
},
{
"@type": "Certification",
"name": "Fair Trade Certified — Sewn",
"issuedBy": {
"@type": "Organization",
"name": "Fair Trade USA",
"url": "https://www.fairtradecertified.org"
},
"description": "Fair Trade Certified sewn product. Garment workers at the cut-and-sew facility receive fair wage premium (paid to worker-controlled community development fund). Facility audited for safe working conditions, no forced or child labor, and right to freedom of association. Fair Trade premium for this product: $X per unit."
}
],
"additionalProperty": [
{
"@type": "PropertyValue",
"name": "Recycled Content",
"value": "100% recycled polyester",
"description": "100% post-consumer recycled polyester yarn (rPET), sourced from post-consumer PET bottles. GRS-certified chain of custody from bottle collection through mechanical recycling through yarn spinning through fabric weaving. Approximately 28 post-consumer 500ml PET bottles per jacket. No virgin petroleum-derived polyester. GRS certificate number: GRS-2026-XXXXXX, issued by Textile Exchange."
},
{
"@type": "PropertyValue",
"name": "Recycled Content Percentage",
"value": "100",
"unitText": "% by weight",
"description": "100% recycled content by weight, meeting the GRS 95%+ threshold for products labeled as pure recycled. Blended products with 20%+ recycled content qualify for GRS at the blended tier. This product: 100% rPET fleece fabric, 100% recycled polyester zipper tape, 100% recycled polyester thread."
},
{
"@type": "PropertyValue",
"name": "Primary Fiber Content",
"value": "100% recycled polyester (rPET)",
"description": "Single-fiber construction: 100% recycled polyester fleece, 300g/m² weight. No blended natural or synthetic fibers. Fabric: Polartec Classic 300 fleece in recycled polyester. Zipper: YKK recycled polyester tape with nickel-free slider."
},
{
"@type": "PropertyValue",
"name": "Carbon Footprint",
"value": "4.2 kg CO2e per garment",
"description": "Scope: cradle-to-gate (raw material extraction through factory gate — excludes retail transport, consumer use phase, and end-of-life). Methodology: Higg Materials Sustainability Index (Higg MSI) for fiber-level lifecycle assessment data; facility-level Scope 1 and Scope 2 data from manufacturing partner Higg Facility Environmental Module (FEM). Industry benchmarks: conventional virgin polyester fleece jacket 8–15 kg CO2e (cradle-to-gate); this recycled polyester jacket: 4.2 kg CO2e, approximately 55% reduction vs conventional virgin polyester equivalent. Not yet cradle-to-grave: consumer washing and drying and end-of-life disposal not included."
},
{
"@type": "PropertyValue",
"name": "Water Usage",
"value": "87",
"unitText": "liters per garment",
"description": "87 liters of water per jacket in the manufacturing process (Bluesign facility water data, Higg FEM verified). Industry context: a conventional cotton t-shirt requires approximately 2,700 liters of water (irrigation + processing). A conventional polyester jacket: approximately 120–180 liters in wet processing. This jacket uses recycled polyester (no agricultural water) and Bluesign-optimized dyeing (closed-loop water system). Microplastic filtration: fabric supplier uses microfiber filtration on all wastewater discharge."
},
{
"@type": "PropertyValue",
"name": "PFC-Free DWR",
"value": "true",
"description": "PFC-free durable water repellent (DWR) coating using C0 technology (zero fluorocarbon content). Free from all per- and polyfluoroalkyl substances (PFAS) including long-chain C8 perfluoroalkyl compounds, C6 alternatives, and short-chain PFAS. Compliant with EU REACH Annex XVII PFC restrictions (effective 2023). DWR application: Bluesign approved process. Performance note: PFC-free DWR provides initial water repellency comparable to fluorinated DWR; to maintain performance, tumble dry on low heat for 10 minutes after washing (heat reactivates DWR polymer bonds). Re-apply DWR spray treatment after approximately 30 wash cycles."
},
{
"@type": "PropertyValue",
"name": "Dyeing Process",
"value": "Bluesign Approved",
"description": "All dyeing and finishing conducted at a Bluesign system partner facility. Bluesign approval certifies: compliance with Bluesign restricted substances list (more restrictive than REACH in 75+ chemical parameters), optimized water and energy consumption with closed-loop water treatment, worker health and safety including chemical handling, ventilation, and PPE standards. Dye class: reactive dyes (lowest ecotoxicity class for polyester fleece application)."
},
{
"@type": "PropertyValue",
"name": "Take-Back Program",
"value": "true",
"description": "Brand garment take-back program available in-store and by mail. Any brand garment in any condition accepted at end of life. Garments sorted at take-back facility: wearable items donated to partner charities; worn items mechanically recycled into insulation fill or industrial rags; damaged fleece items shredded and re-spun into recycled polyester yarn for new fabric (closed-loop recycling, subject to fiber quality). No fee for take-back by mail using prepaid label available at brand website."
}
],
"potentialAction": {
"@type": "ReturnAction",
"name": "Garment Take-Back Program",
"description": "Return any brand garment at end of life for recycling or donation. Free prepaid mail label available.",
"target": "https://example-brand.com/take-back"
},
"manufacturer": {
"@type": "Organization",
"name": "Example Sustainable Brand",
"url": "https://example-brand.com",
"sameAs": [
"https://example-brand.com/sustainability-report-2025",
"https://www.bcorporation.net/en-us/find-a-b-corp/company/example-brand"
]
},
"offers": {
"@type": "Offer",
"price": "149.00",
"priceCurrency": "USD",
"availability": "https://schema.org/InStock"
}
}
</script>
Encoding Carbon Footprint When Schema.org Has No Dedicated Property
As of 2026, schema.org has no dedicated carbonFootprint property for Product. The correct approach is additionalProperty with a PropertyValue node where the name is "Carbon Footprint" and the value encodes the numeric figure with units. The description field carries the methodology, scope boundary, and comparators that make the number interpretable.
Scope boundary specification is mandatory
A carbon footprint number without a declared scope boundary is uninterpretable and non-comparable across brands. The two most common scopes are cradle-to-gate (raw material extraction through the factory gate — the scope most brands can measure accurately using Higg MSI fiber data plus facility energy data) and cradle-to-grave (includes retail transport, consumer washing and drying over the garment's useful life, and end-of-life disposal — the more complete but harder-to-verify scope). Always specify which scope your figure represents. Cradle-to-gate carbon footprints are typically 30–60% lower than cradle-to-grave for fashion garments due to the significant energy consumed by repeated consumer washing and drying over a garment's lifespan.
Common LCA methodologies for fashion carbon footprints
The Higg Materials Sustainability Index (Higg MSI) is the most widely used methodology in fashion: it provides standardized, peer-reviewed lifecycle assessment data at the fiber level (kg CO2e per kg of fiber) from Textile Exchange and the Sustainable Apparel Coalition. Brands combine Higg MSI fiber data with facility-level energy consumption data from the Higg Facility Environmental Module (FEM). The Environmental Product Declaration (EPD, ISO 14025 / EN 15804) is a third-party verified declaration using a full lifecycle assessment — the most rigorous and externally verifiable methodology, required for some EU procurement and Green Public Procurement frameworks. The Product Environmental Footprint (PEF) is the EU-developed methodology standardizing environmental impact calculation across 16 impact categories, increasingly relevant for EU Digital Product Passport requirements taking effect from 2026 onwards.
Garment carbon footprint benchmarks for context
| Garment type | Conventional (kg CO2e) | Recycled / organic (kg CO2e) | Scope |
|---|---|---|---|
| Cotton t-shirt | 4–7 kg CO2e | 2–4 kg CO2e (organic cotton) | Cradle-to-gate |
| Denim jeans | 20–30 kg CO2e | 12–18 kg CO2e (organic cotton / recycled denim) | Cradle-to-gate |
| Polyester fleece jacket | 8–15 kg CO2e | 4–7 kg CO2e (recycled polyester, rPET) | Cradle-to-gate |
| Down jacket | 15–25 kg CO2e | 10–18 kg CO2e (recycled shell + RDS down) | Cradle-to-gate |
| Wool sweater | 25–50 kg CO2e | 18–35 kg CO2e (ZQ Merino / RWS certified) | Cradle-to-gate (methane emissions dominate) |
| Nylon swimwear | 6–10 kg CO2e | 3–6 kg CO2e (ECONYL recycled nylon) | Cradle-to-gate |
Sustainable Fashion Metafield Namespace
Store all sustainability data in a sustain.* metafield namespace in Shopify. Each field maps to a corresponding additionalProperty in your JSON-LD output via Shopify's theme JSON-LD snippet. Use Shopify's metafield definitions to enforce type validation at the point of data entry.
| Metafield key | Type | Notes |
|---|---|---|
sustain.recycled_content_pct | number_integer | % recycled content by weight (GRS-verified). 0–100. |
sustain.primary_fiber | single_line_text | E.g., "68% recycled polyester / 22% organic cotton / 10% elastane" |
sustain.carbon_footprint_kg_co2e | number_decimal | kg CO2e per garment, cradle-to-gate. Specify methodology in metafield description. |
sustain.water_usage_liters | number_integer | Liters of water per garment production (manufacturing phase only) |
sustain.grs_certified | boolean | Global Recycled Standard certification present and current |
sustain.gots_certified | boolean | Global Organic Textile Standard certification present and current |
sustain.bluesign_approved | boolean | Bluesign approved fabric and/or processing |
sustain.pfc_free | boolean | PFC/PFAS-free DWR or finishing — all fluorocarbon compounds absent |
sustain.fair_trade_certified | boolean | Fair Trade Certified factory (Fair Trade USA or Fairtrade International) |
sustain.b_corp | boolean | B Corp certified company (brand-level, not product-level) |
sustain.take_back_program | boolean | Brand offers garment take-back or in-store repair program |
sustain.dye_process | single_line_text | Conventional / Bluesign / GOTS / Low-Impact / Natural / Waterless / Solution-Dyed |
sustain.certifications | list.single_line_text | All active sustainability certifications for this product (list, deduplicated) |
sustain.carbon_offset | boolean | True if residual emissions offset by verified carbon credits. Must also specify registry (Gold Standard / Verra VCS / Plan Vivo) in description. |
sustain.higg_facility_module | boolean | True if manufacturing facility Higg FEM verified (Facility Environmental Module — third-party verified score) |
5 Critical Fashion Sustainability Schema Mistakes
- Using
sustainabilityFeaturetext strings instead ofadditionalPropertyfor machine-readable data.sustainabilityFeatureis designed for NLP text patterns consumed by language models, not for filterable structured values. Recycled content percentage, carbon footprint in kg CO2e, and PFC-free boolean status must also exist inadditionalPropertywith typed values — so AI agents can apply numeric filters like "jacket with less than 5 kg CO2e carbon footprint, GRS certified, 90%+ recycled content." Text strings insustainabilityFeatureenable semantic matching; typed values inadditionalPropertyenable numeric filtering. Both are required. - Claiming "recycled materials" without specifying the percentage and GRS certification status separately. "Contains recycled materials" as a text claim can be legally satisfied by 5% recycled filler. GRS certification requires 20%+ recycled content with third-party chain-of-custody verification. Encode both the percentage (
recycledContentPctinadditionalProperty) and the certification (hasCertificationwith GRS as issuing body) as separate data nodes. The percentage without certification is a self-declared claim; the certification without the percentage is incomplete. AI agents need both to distinguish genuine recycled products from greenwashing. - Conflating OEKO-TEX Standard 100 with a sustainability certification. OEKO-TEX Standard 100 tests finished products for the absence of harmful substances (restricted azo dyes, formaldehyde, heavy metals, pesticide residues). It explicitly does NOT certify environmental impact, recycled content, carbon footprint, or social conditions. A product with OEKO-TEX 100 could be manufactured from virgin synthetic fibers in a facility with no environmental controls, using conventional dyeing chemistry at high water and energy consumption — it is a human health and safety standard, not a sustainability standard. When encoding OEKO-TEX 100 in
hasCertification, include a clear description of the certification scope to prevent AI agents from misclassifying it as an environmental credential. - Not encoding PFC-free status as an explicit boolean in
additionalProperty. PFC-free DWR is a binary purchase filter for a large and growing segment of buyers: EU consumers where long-chain PFCs are restricted under REACH Annex XVII; US environmentally-conscious buyers avoiding PFAS exposure; outdoor brands whose retail buyers require PFAS-free supplier products as a condition of listing. Embedding "PFAS-free" only within a product description paragraph — or in asustainabilityFeaturetext string — does not create a filterable structured data field. ThepfcFreeboolean must appear as a typedadditionalPropertyfor AI agent filter queries to resolve it correctly. - Encoding carbon offset claims without specifying the registry, standard, and project ID. "Carbon neutral" and "carbon offset" without a verification registry are marketing claims with no structured meaning. Voluntary carbon offsets must reference the standard under which they were issued (Gold Standard, Verra Verified Carbon Standard (VCS), Plan Vivo, American Carbon Registry), the registry project ID or serial number, and the vintage year of the credits. Without these fields, AI agents cannot distinguish third-party-verified retirement of Gold Standard credits from unverified internal accounting. The FTC Green Guides (US) and EU Green Claims Directive (effective 2026) both require substantiation of carbon offset claims — encode the substantiation in structured data, not just in marketing copy.
Frequently Asked Questions
How do I encode recycled content percentage in schema.org?
Use additionalProperty with a typed PropertyValue containing both the percentage value and a description referencing the GRS certificate number. Never rely on sustainabilityFeature text strings alone for percentage data — AI agents need the numeric value in a typed field to apply "greater than X% recycled content" filters. Encode the percentage separately from the fiber description, and link the GRS certification in a separate hasCertification node with Textile Exchange as the issuing Organization.
What is the difference between GRS, GOTS, and Bluesign certification in schema.org?
GRS (Textile Exchange) certifies recycled content percentage with third-party chain of custody — not organic fiber, not social standards beyond basic labor requirements. GOTS (GOTS Association) certifies organic fiber origin plus ecological processing plus full ILO social standards across the supply chain — not recycled content. Bluesign (bluesign technologies ag) certifies chemical management and resource efficiency in dyeing and finishing at the facility level — not fiber content, not full supply chain. Encode each as a separate hasCertification node with the issuing Organization and a description of the certification scope, so AI agents can distinguish a product with all three from one with only one.
How do I encode carbon footprint per garment in schema.org when there is no dedicated property?
Use additionalProperty with name "Carbon Footprint" and value in kg CO2e per garment. The description field must specify: the scope boundary (cradle-to-gate or cradle-to-grave), the methodology (Higg MSI, EPD ISO 14025, or EU PEF), and the functional unit (per finished garment). Industry benchmarks for reference: t-shirt 4–7 kg CO2e, denim jeans 20–30 kg CO2e, fleece jacket 8–15 kg CO2e (all conventional, cradle-to-gate). Always declare methodology — carbon figures from different methodologies are not directly comparable across brands.
How do I encode PFC-free DWR status in schema.org?
Use additionalProperty with name "PFC-Free DWR" and boolean value true. The description should specify the DWR technology (C0 — zero fluorocarbon), the PFAS categories absent (long-chain C8, C6, and short-chain alternatives), and the EU REACH Annex XVII compliance status. Also add "PFC-free — no per- and polyfluoroalkyl substances in fabric or DWR coating" to sustainabilityFeature for NLP matching. Include a consumer-facing note about PFC-free DWR reactivation requirements (tumble dry after washing) — this reduces returns from buyers who expect fluorinated-DWR performance without reactivation.
What is the sustainabilityFeature property and when should I use it vs additionalProperty?
sustainabilityFeature is for natural language text strings designed for NLP consumption — semantic query matching by AI language models and search systems. additionalProperty is for typed, filterable structured values — numeric percentages, booleans, and categorical codes. Use both for the same sustainability fact: sustainabilityFeature carries the human-readable pattern ("Made from 100% GRS certified recycled polyester"), and additionalProperty carries the machine-readable value (recycledContentPct: 100, grs_certified: true). AI agents applying filters need the typed additionalProperty values. AI agents matching natural language queries use sustainabilityFeature strings. Neither alone is sufficient.
Is your sustainable fashion store's structured data complete?
CatalogScan checks recycled content, GRS certification, carbon footprint, and PFC-free status in one free scan.
Run Free ScanRelated Guides
- EU Ecodesign & Repairability Schema — Spare Parts, Repair Index, Disassembly
- Shopify Outdoor Sporting Goods Schema — Activity, Waterproofing, Weight Rating
- Country of Origin & Provenance Schema — Made In, Assembled In, Sourced From
- Shopify Handmade & Artisan Product Schema — Maker Attribution, Craft Process, Edition
- CatalogScan Blog — AI Shopping Agent Optimization