product_nameProduct Name
Commercial name of the product
Shown as the headline on the public passport and in search.
- Type
text- Publishing
Publishing asks for it.
- Access tier
publicPublic
Nothing matches that.
Fields
Every field of a textile passport: what it is, how to send it and what publishing asks for.
This page lists every field that GET /categories/{category}/schema returns. Some rows add what the endpoint does not return, such as the format a text value must have, the care symbols a field accepts or the keys of a list's entries. They come from the API's own code. The endpoint also returns the conditions and notes behind each legal reference. This page does not list each category's own checks. Such a check can still ask for a field, even when the field's row shows no publishing line, or shows an exception that applies to your product. A check can also refuse a value. POST …/validate runs these checks on your passport and names each problem it finds.
Paths, methods, scopes, field names, error codes and validation rule names are published in English, because English is the language of the interface itself — they are what a caller types or matches on. So is every code sample and JSON payload, and the exact sentence an error response carries: /v1 does not read Accept-Language, so translating what the API literally sends would misdescribe it. Everything written about them follows the language of this page.
text"…" Some text fields also check the format. Their row names the check.multiselect["EU"]url"https://example.com/document.pdf"number50select"kg_co2e"array["…"]date"2027-03-01"product_nameProduct NameCommercial name of the product
Shown as the headline on the public passport and in search.
text
Publishing asks for it.
public Public
gtinGTINAlready have a barcode? The number under it is your GTIN. Required to publish.
The GTIN links the digital passport to the physical barcode on the label.
text
format_gtin Publishing refuses a value in another format.
Publishing asks for it.
A saved size or colour with its own barcode also counts.
GS1 / GTIN GS1 General Specifications voluntaryESPR (Reg (EU) 2024/1781) Annex III(b), (c) anticipatedThe status is the endpoint's own classification.
public Public
serial_numberSerial NumberItem-level serial number for unit-specific identification
text
GPSR (Reg (EU) 2023/988) Art. 9 in_forcepublic Public
product_descriptionProduct DescriptionA clear description of the product and its intended use
text
Publishing asks for it.
public Public
product_categoryProduct CategoryGeneral product type (e.g. T-Shirt, Jacket, Bedding). Optional — helps organize your passports.
text
public Public
markets_sold_intoMarkets sold intoWhere this product is placed on the market. Determines which market-specific rules (e.g. France AGEC) apply. Select France (FR) specifically if you sell there.
Used only to tailor compliance guidance — never shown on the public passport.
multiselect
EU European Union / EEA (general)FR FranceDE GermanyIT ItalyES SpainNL NetherlandsBE BelgiumPL PolandUK United KingdomUS United StatesOTHER Other / rest of worldPublishing can refuse a value outside the list. POST …/validate tells you which.
restricted Restricted
commodity_codeCommodity code (HS / CN / TARIC)Customs classification code for this product (6-digit HS, 8-digit EU CN, or 10-digit TARIC). You likely already use this for shipping and import declarations.
text
format_commodity_code POST …/validate warns about a value in another format.
ESPR (Reg (EU) 2024/1781) Annex III(d) anticipatedpublic Public
manufacturer_nameManufacturer NameThe manufacturer's name, registered trade name or registered trade mark.
text
Publishing asks for it.
GPSR (Reg (EU) 2023/988) Art. 9(6) in_forcepublic Public
manufacturer_addressManufacturer AddressThe manufacturer's postal address. If a single contact point has a different postal address, add it too.
text
Publishing asks for it.
GPSR (Reg (EU) 2023/988) Art. 9(6) in_forcepublic Public
manufacturer_countryManufacturer CountrySelect the manufacturer's country.
text
format_country_code Publishing refuses a value in another format.
Publishing asks for it.
GPSR (Reg (EU) 2023/988) Art. 9(6) in_forcepublic Public
manufacturer_emailManufacturer EmailThe manufacturer's electronic address, such as an email address.
Where the General Product Safety Regulation applies, it asks manufacturers for a postal and an electronic address.
text
format_email Publishing refuses a value in another format.
GPSR (Reg (EU) 2023/988) Art. 9(6) in_force_conditionalConditions apply. The endpoint returns them in regulatory_basis[].applies_when.
public Public
manufacturer_websiteManufacturer WebsiteThe manufacturer's website.
url
public Public
eori_numberEORI NumberEconomic Operators Registration and Identification number for EU customs
text
format_eori Publishing refuses a value in another format.
restricted Restricted
eu_responsible_personEU Responsible PersonName and contact of the EU-based responsible person — needed to sell in the EU when the manufacturer is outside it, unless you name an EU importer instead
text
GPSR (Reg (EU) 2023/988) Art. 16(1) in_forceMarket Surveillance Reg (EU) 2019/1020 Art. 4 in_forceESPR (Reg (EU) 2024/1781) Annex III(k) anticipatedpublic Public
eu_importerEU ImporterWhen a company other than you places the product on the EU market, enter that importer here. Give its name, registered trade name or registered trade mark, its postal address and an electronic address, such as an email address.
The importer is a distinct economic operator from the manufacturer — the EU-established business that brings the product into the Union.
text
GPSR (Reg (EU) 2023/988) Art. 11(3) in_force_conditionalConditions apply. The endpoint returns them in regulatory_basis[].applies_when.
ESPR (Reg (EU) 2024/1781) Art. 29(3) anticipatedESPR (Reg (EU) 2024/1781) Annex III(j) anticipatedpublic Public
carbon_footprint_valueCarbon FootprintProduct carbon footprint. Choose the matching unit of measurement in the selector.
number
Sent in carbon_footprint_unit.
carbon_footprint_unit: kg_co2e, kg_co2e_per_kg, kg_co2e_per_m2
public Public
carbon_footprint_unitCarbon footprint: unit of measurementUnit of measurement for the carbon footprint value.
select
kg_co2e kg CO₂e (per unit)kg_co2e_per_kg kg CO₂e / kg (per weight)kg_co2e_per_m2 kg CO₂e / m² (per area)Publishing can refuse a value outside the list. POST …/validate tells you which.
public Public
carbon_footprint_basisCarbon Footprint BasisHow the carbon footprint was calculated.
This records the calculation method. Keep supporting evidence for the footprint; selecting a method does not substantiate the result.
select
iso_14067 ISO 14067 (product carbon footprint)pef EU PEF / PEFCRghg_protocol GHG Protocol Product Standardiso_14040_44 ISO 14040/44 LCAsupplier_data Supplier-provided / EPD dataestimate Internal estimatePublishing can refuse a value outside the list. POST …/validate tells you which.
UCPD (Dir 2005/29/EC) Art. 12 in_forcepublic Public
recyclable_content_percentageRecyclable Content (%)Percentage of the product that is recyclable at end of life
number
min: 0 max: 100
public Public
recycled_content_percentageRecycled Content (%)Percentage of the product made from recycled materials
number
min: 0 max: 100
AGEC Décret 2022-748 recycled-material % FR in_force_conditionalConditions apply. The endpoint returns them in regulatory_basis[].applies_when.
ESPR (Reg (EU) 2024/1781) Annex I(h) anticipatedpublic Public
substances_of_concernSubstances of ConcernList of substances of concern present above threshold concentrations, or "none declared"
array item_type: string
REACH (Reg (EC) 1907/2006) Art. 33 in_forceSCIP / WFD (Dir 2008/98/EC) Art. 9(1)(i) in_forceAGEC Décret 2022-748 Code de l'environnement art. R. 541-228 IX FR in_force_conditionalConditions apply. The endpoint returns them in regulatory_basis[].applies_when.
ESPR (Reg (EU) 2024/1781) Art. 7(5) anticipatedpublic Public
conformity_declaration_urlDeclaration of Conformity URLLink to the EU Declaration of Conformity document, or upload the PDF.
url
authority Authority only
conformity_declaration
Its id is sent in conformity_declaration_url__document_id.
compliance_standardsCompliance StandardsSelect the standards your product complies with.
multiselect
reach REACH (EC 1907/2006)eu_ecolabel EU Ecolabeloeko_tex_100 OEKO-TEX Standard 100gots GOTS (Global Organic Textile Standard)iso_14184 EN ISO 14184 — Formaldehydeiso_17075 EN ISO 17075 — Chromium VIen_14682 EN 14682 — Cords & Drawstrings (children)iso_105 ISO 105 — Colour Fastnessiso_13934 ISO 13934 — Tensile Strengthiso_12947 ISO 12947 — Abrasion Resistanceiso_12945 ISO 12945 — Pilling Resistanceen_13402 EN 13402 — Size Designationbci BCI (Better Cotton Initiative)grs GRS (Global Recycled Standard)bluesign bluesign®Publishing can refuse a value outside the list. POST …/validate tells you which.
public Public
recycling_instructionsRecycling InstructionsInstructions for recycling the product at end of life
text
public Public
disposal_instructionsDisposal InstructionsInstructions for safe disposal if the product cannot be recycled
text
public Public
mono_material_percentageMono-material PercentagePercentage of product made from a single recyclable material (0-100). Products above 85% are significantly easier to recycle.
number
min: 0 max: 100
public Public
recyclability_gradeRecyclability GradeKept for values already entered; no longer asked.
select
A A — Fully recyclable (mono-material, no contaminants)B B — Recyclable with separation (removable non-recyclable parts)C C — Partially recyclable (blended, some components recoverable)D D — Difficult to recycle (complex blends, coatings)E E — Not recyclable (inseparable materials or contaminating components)Publishing can refuse a value outside the list. POST …/validate tells you which.
public Public
Held back from the public passport page. self_declared_label
disassembly_instructions_urlDisassembly InstructionsURL to a guide for separating non-recyclable components (zippers, buttons, coatings) for recycling — or upload the file.
url
public Public
document
Its id is sent in disassembly_instructions_url__document_id.
takeback_scheme_urlTake-back SchemeURL to collection or take-back program information — or upload the file.
url
ESPR (Reg (EU) 2024/1781) Art. 7(2)(b)(ii) anticipatedpublic Public
document
Its id is sent in takeback_scheme_url__document_id.
material_compositionMaterial CompositionFiber content of your product. Add each fiber type and its percentage (must total 100%).
array
fiber The fibre's name, as text.percentage The fibre's share, in %.recycledPercentage How much of this fibre is recycled, in %.country A country code for this fibre: two capital letters, such as PT.[
{
"fiber": "cotton",
"percentage": 60,
"recycledPercentage": 20,
"country": "PT"
},
{
"fiber": "polyester",
"percentage": 40
}
]Publishing asks for it.
Reg (EU) 1007/2011 Art. 9 in_forceESPR (Reg (EU) 2024/1781) Annex I(d) anticipatedpublic Public
material_composition_methodComposition Testing MethodHow the fibre composition was determined. EN 12127 measures fabric mass per area; it does not determine fibre composition.
select
iso_1833 ISO 1833 — Quantitative chemical analysisiso_20705 ISO 20705 — Quantitative microscopyiso_17751 ISO 17751 — Animal fibre identification and quantificationen_12127 EN 12127 — Mass per unit areamanufacturer_declaration Manufacturer declarationsupplier_certificate Supplier certificateother OtherPublishing can refuse a value outside the list. POST …/validate tells you which.
restricted Restricted
material_componentsComponent breakdown (optional)Optional per-component fibre breakdown (e.g. Shell, Lining, Trim) for multi-component products. The flat material composition above stays the source of truth; this only adds detail.
array
component The name of a part of the product, such as Shell or Lining.fibers The part's fibres. Each entry has the keys fiber, percentage and recycledPercentage, as in material_composition.[
{
"component": "Shell",
"fibers": [
{
"fiber": "cotton",
"percentage": 100
}
]
},
{
"component": "Lining",
"fibers": [
{
"fiber": "polyester",
"percentage": 100
}
]
}
]Reg (EU) 1007/2011 Art. 11 in_forceESPR (Reg (EU) 2024/1781) Annex I(d) anticipatedpublic Public
pfas_declarationPFAS DeclarationWhether PFAS (per- and polyfluoroalkyl substances) were intentionally added. France's restrictions on PFAS in clothing and footwear apply from 1 January 2026, subject to concentration limits, exemptions and transitional rules.
Leaving this empty means "not declared". Check supplier evidence before declaring no intentional addition. This does not establish absence of PFAS or legal compliance.
select
no_intentionally_added No intentionally added PFAScontains_intentionally_added Contains intentionally added PFASPublishing can refuse a value outside the list. POST …/validate tells you which.
public Public
microfibre_sheddingMicrofibre releaseWhether this product releases plastic microfibres when washed. Required for products over 50% synthetic fibres under France's AGEC law (for in-scope sellers).
select
released Releases plastic microfibres when washednot_applicable Not applicable (not predominantly synthetic)unknown Unknown / not assessedPublishing can refuse a value outside the list. POST …/validate tells you which.
AGEC Décret 2022-748 microfibre FR in_force_conditionalConditions apply. The endpoint returns them in regulatory_basis[].applies_when.
ESPR (Reg (EU) 2024/1781) Annex I(p) anticipatedpublic Public
net_weight_gramsNet WeightFinished-product net weight in grams. Also the "mass" input for France's coût environnemental (Ecobalyse) score.
Weigh the finished product without packaging.
number
g
min: 1
public Public
care_instructions_textCare Instructions (Text)Human-readable care instructions as free text
text
public Public
care_instructionsCare InstructionsSelect the care symbols that apply to your product.
array item_type: string
machine_wash_30 Machine wash 30°Cmachine_wash_40 Machine wash 40°Cmachine_wash_50 Machine wash 50°Cmachine_wash_60 Machine wash 60°Cmachine_wash_95 Machine wash 95°Cgentle_wash_30 Gentle machine wash 30°Cgentle_wash_40 Gentle machine wash 40°Cvery_gentle_wash_30 Very gentle machine wash 30°Chand_wash Hand washdo_not_wash Do not washany_bleach Bleach (any bleach allowed)non_chlorine_bleach Non-chlorine bleach onlydo_not_bleach Do not bleachtumble_dry_normal Tumble dry, normal heattumble_dry_low Tumble dry, low heattumble_dry_high Tumble dry, high heatdo_not_tumble_dry Do not tumble dryline_dry Line dry (hang to dry)flat_dry Dry flatdrip_dry Drip dryiron_low Iron, low temperature (max 110°C)iron_medium Iron, medium temperature (max 150°C)iron_high Iron, high temperature (max 200°C)do_not_iron Do not ironno_steam Iron without steamdry_clean_any Dry clean (any solvent)dry_clean_petroleum Dry clean, petroleum solvent onlydo_not_dry_clean Do not dry cleanwet_clean Professional wet cleaningdo_not_wet_clean Do not wet cleanPublishing can refuse a value outside the list. POST …/validate tells you which.
public Public
safety_informationSafety information / warningsAny safety warnings or precautions a consumer needs (e.g. choking-hazard cords on childrenswear, flammability notes, allergen finishes). Leave empty if the product is safe without instructions.
text
GPSR (Reg (EU) 2023/988) Art. 9 in_forceESPR (Reg (EU) 2024/1781) Annex III(f) anticipatedpublic Public
country_of_manufactureCountry of ManufactureSelect the country where the product was made.
text
format_country_code Publishing refuses a value in another format.
AGEC Décret 2022-748 geographic traceability FR in_force_conditionalConditions apply. The endpoint returns them in regulatory_basis[].applies_when.
public Public
manufacturing_dateManufacturing dateDate on which this item or batch was manufactured
date
restricted Restricted
batch_numberBatch NumberProduction batch identifier for traceability
text
GPSR (Reg (EU) 2023/988) Art. 9 in_forcerestricted Restricted
country_of_spinningCountry of SpinningSelect the country where the yarn was spun (used by France's coût environnemental calculation).
text
format_country_code Publishing refuses a value in another format.
Décret n° 2025-957 (affichage environnemental) coût environnemental calculation inputs FR in_force_conditionalConditions apply. The endpoint returns them in regulatory_basis[].applies_when.
public Public
country_of_weaving_knittingCountry of Weaving/KnittingSelect the country where weaving or knitting mainly took place, if this stage exists. AGEC requires this information for covered new consumer textiles sold in France by businesses that meet the applicable turnover and volume conditions.
text
format_country_code Publishing refuses a value in another format.
AGEC Décret 2022-748 geographic traceability FR in_force_conditionalConditions apply. The endpoint returns them in regulatory_basis[].applies_when.
public Public
country_of_dyeing_printingCountry of Dyeing/PrintingSelect the country where dyeing or printing mainly took place, if this stage exists. AGEC requires this information for covered new consumer textiles sold in France by businesses that meet the applicable turnover and volume conditions.
text
format_country_code Publishing refuses a value in another format.
AGEC Décret 2022-748 geographic traceability FR in_force_conditionalConditions apply. The endpoint returns them in regulatory_basis[].applies_when.
public Public
country_of_confectionCountry of Confection (Assembly)Select the country where garment assembly mainly took place, if this stage exists. AGEC requires this information for covered new consumer textiles sold in France by businesses that meet the applicable turnover and volume conditions.
text
format_country_code Publishing refuses a value in another format.
AGEC Décret 2022-748 geographic traceability FR in_force_conditionalConditions apply. The endpoint returns them in regulatory_basis[].applies_when.
public Public
number_of_referencesNumber of ReferencesFor France's environmental-cost calculation, enter your brand's maximum number of clothing references offered on the same day during the calendar year, within this product's market segment. Count each product/colour once across all sizes. Apply the official sales-channel and exclusion rules.
number
min: 1 max: 999999
Décret n° 2025-957 (affichage environnemental) coût environnemental calculation inputs FR in_force_conditionalConditions apply. The endpoint returns them in regulatory_basis[].applies_when.
restricted Restricted
priceRetail price (€)Unit retail price in euros including VAT, excluding promotions and sales, on the reference sales channel used for France's environmental-cost calculation.
Feeds the France filing only — it is never shown on the public passport.
number
min: 1 max: 1000
Décret n° 2025-957 (affichage environnemental) coût environnemental calculation inputs FR in_force_conditionalConditions apply. The endpoint returns them in regulatory_basis[].applies_when.
restricted Restricted
epr_registration_numberEPR Producer Registration NumberYour producer registration number under an EU textile Extended Producer Responsibility (EPR) scheme.
For France this is your ADEME Unique Identification Number (UIN).
text
public Public
expected_lifetime_wearsExpected Lifetime (Wears)Estimated number of wears under normal use conditions
number
min: 1
public Public
repairability_scoreRepairability ScoreKept for values already entered; no longer asked.
number
min: 0 max: 10
public Public
Held back from the public passport page. self_declared_label
repair_instructions_urlRepair Instructions URLLink to repair guides, spare parts, or service centers — or upload the file.
url
public Public
document
Its id is sent in repair_instructions_url__document_id.