The circularity.ID® Open Data Standard allows fashion brands to publish their product data in a format that can be utilised by a variety of software applications along the product lifecycle.
circularity.ID® Open Data Standard is contains of immutable product data including material and chemical components and a mutable set of data that contains product information such as product images, description, sustainability consumer information and service offers.
Schema documentation
For each product we ask for information in all three categories. Product, assembly and material. It seems a lot but not all information are mandatory thoug. In the following you may see all attributes, data points and data types for those three categories.
circularity.ID® Open Data Standard Schema V 4.0
-
Unit
Attribute Data point description Type Requirements sgtin Serialized Global Trade Item Number (allows you to individually identify different units of the same product) unique String Optional -
Product
Attribute Data point description Type Requirements name Product Name (as defined by the brand, e.g “Slim Summer Shirt”. Text Mandatory product_name Name on product sites to be displayed (e.g “Slim Summer Shirt - black”.) Text Mandatory product_category Category of product; e.g apparel, footwear, accessories Select - clothing
- accessories
- footwear
- other
Mandatory product_type Type of product; e.g trousers, shirt, dress etc (options to be found in old schema) Select - Options - Jacket
- Pants
- Blouse
- Shirt
- Dress
- Knitwear
- Skirt
- Blazer
- Denim
- Accessories
- Bags
- Shoes
- Overall
- T-shirt
- Top
- Sweater
- Others
Mandatory size_country_code Which size metric is applied; EU, US etc MultiSelect - EU
- FR
- IT
- UK
- International
Mandatory disassembly_instructions_sorters Description on how to take components apart at sorting/recycling stage if needed. Text Optional disassembly_instructions_user Description on how to take components apart for users. Text Optional water_properties Water properties on the finished product. Select - No Water
- Properties
- Waterproof
- Water
- Repellent
- Water Resistant
Optional brand_name The fashion brand, e.g. H&M, Hugo Boss, etc Text Mandatory sub_brand_name The sub-brand of the product, if applicable Text Optional brand_description Description of the brand written by the brand Text Optional parent_organization A company owning several brands, like H&M group, Inditex, Kering etc. Text Optional brand_logo Brand logo Image Optional brand_image Image that expresses brand's identity or DNA (in addition to logo) Image Optional market_segment Market segment of the product Select - mass-market
- mid-price
- premium
- luxury
Optional price_currency Currency of the price listed Select - USD
- EUR
- GBP
Optional sustainability_info Sustainability statement written by the brand Text Optional production_description Description of production of the garment written by the brand “e.g produced with love in Berlin“ Text Optional production_image Add an image of the production Image Optional services The type of service the brand offers to prolong the life of the product (repair, resell, rental, redesign, take-back system - list of choices in old schema) Optional, zero or more services name Text Optional service_type MultiSelect - Other
- Repair
- Resell
- Rental
- Redesign
- Take back for recycling
- Take back for reuse
Mandatory, defaults to “Other” description Description of service written by the brand Text Optional circular_design_strategy Applied circular design strategy MultiSelect - Material Cyclability
- Mono Cycle
- Disassembly
- Longevity
- Physical Durability
- Aesthetic Durability
- Emotional Durability
- Repairability
- Participatory Design
- Modularity
- Transformability
- Adjustable Sizing
- Minimal Waste
Optional, zero or more strategy_description Description of the circular design strategy used written by the brand Text Optional -
Variation
Attribute Data point description Type Requirements name Variation name of product (e.g. “black”) Text Mandatory product_description Consumer-facing description of product as written by the brand Text Mandatory sku Stock Keeping Unit or Article Number Text, min length 2 Optional gtin Global Trade Item Number is an identifier for trade items Number int Optional purchase_order_number Purchase Order Number. A PO Number uniquely identifies a purchase order and is generally defined by the buyer. Text Optional gender Target gender Select - Options - female
- male
- unisex
- gender-neutral
- genderless
Optional age_group Target age group MultiSelect - Options - Adult
- Teenager
- Child
- Toddler
- Baby
- Other
- Unclassified
Optional season_of_sale The season of original sale in which the product belongs to; spring/summer, autumn/winter. Text Optional year_of_sale The year in which the product is originally intended to be sold Number int Mandatory product_images Images of the product Image Mandatory, one or more net_weight Weight of the total product Number float Optional colourway Colour of product as named by the brand (e.g. Midnight blue) Text Optional assigned_colour_category Assigned color category the product belongs to MultiSelect - Options - beige
- black
- black & white
- blue
- burgundy
- brown
- coral
- indigo
- gold
- green
- grey
- khaki
- multicoloured
- navy
- nude
- off-white
- orange
- pink
- purple
- red
- rose
- silver
- taupe
- teal
- turquoise
- uncoloured
- white
- yellow
- other
Mandatory size Size of product Text Mandatory price Price of product Number float Optional certification certification_standard Certifications on garment-level (not material level) Select - Options - Bluesign
- C2C Cradle to Cradle
- EU Ecolabel
- Fair Trade
- Global Organic Textile Standard
- Global Recycled Standard
- Leather Standard by Oeko-Tex
- MADE IN GREEN by Oeko-Tex
- Organic 100 Content Standard
- Organic Blended Content Standard
- PETA certified
- Responsible Wool Standard
- Standard 100 by Oeko-Tex
- V-Label
Optional certification_file File Optional material_composition Composition as displayed on care label Text Mandatory Does the product comply with REACH? Compliance with chemical regulations or standards can determine recycling cycle Select - Options - Yes
- No
- I don't know
Optional Does the product comply with AFIRM? Compliance with chemical regulations or standards can determine recycling cycle Select - Options - Yes
- No
- I don't know
Optional Does the product comply with ZDHC MRSL? Compliance with chemical regulations or standards can determine recycling cycle Select - Options - Yes
- No
- I don't know
Optional care_guide Description on how to take care of the product, e.g ‘wash carefully in cold water, air to dry etc’ Text Optional care_images Image of care icons Image Optional, zero or more sustainability_images Sustainability image by the brand Image Optional country_of_origin Made in... Select - Options: ISO country list Mandatory product_steps step_type The production step type Select - Options - Full Garment Supply
- Cut, Make, Trim
- Embellishing
- Laundry
- Packaging & Shipping
- Dyeing
- Finishing
- Printing
Mandatory country Country of each step Select - Options: ISO country list Mandatory organization_name Text Optional street_address Text Optional postal_code Text Optional city Text Optional oar Facility's Open Apparel Registry number Text Optional gln Facility's Global Location Number Text Optional dyeing_process If step_type is dyeing Select - Undyed
- Piece Dyed
- +dip dyed
- +batik dyed
Optional dye_stuff If step_type is dyeing Select - No dye stuff
- Acid dye
- Analine dye
- Azo dye
- Basic dye
- Chrome dye
- Direct dye
- Disperse dye
- Mordant dye
- Natural dye
- Pigment (natural)
- Pigment (biosynthetic)
- Pigment (synthetic)
- Reactive dye
- Vat Dye
- Sulfur Dyes
- Others
Optional printing_process The printing method used for the material.
If step_type is printingSelect - No Printing
- Batik printed
- Digital printed
- Hand painted
- Inkjet printed
- Roller printed
- Screen printed
- Transfer printed
Mandatory print_stuff The print stuff required for the printing method.
If step_type is printingText Optional product_finishing If step_type is finishing Select - Options - Untreated
- Unknown
- Antimicrobial treatment
- Anti-soiling treatment
- Antistatic
- Bio-polishing
- Enzyme Washing
- Embroidery
- Embossing
- Debossing
- Laser cutting and engraving
- Flame retardant treatment
- Garment dyeing
- Napping and Sueding
- Optical Brighteners
- Shrinkage Control
- Stain repellent
- Wax
- Wrinkle-free treatment
Mandatory assembly Mandatory - one or more -
Assembly
Attribute Data point description Type Requirements name Text Mandatory material Mandatory - one or more -
Material
Attribute Data point description Type Requirements name Name of material Text Mandatory article_number Article number of material Text Optional description Description of material by supplier Text Optional components component_name We use this when the content is set to “other” Text Optional - Mandatory when content is “other” content The name of the fibres used in the material (e.g. Cotton, Silk...) Select - Options -
Natural
- Abaca
- Bamboo
- Banana
- Bee wax
- Coconut
- Cork
- Corn
- Corozo
- Cotton
- Food-crop waste
- Fungi
- Hemp
- Jute
- Kapok
- Lignin
- Linen
- Manila Hemp
- Mother of Pearl
- Mycelium
- Natural Latex
- Natural Rubber
- Nettle
- Nuts
- Organic Cotton
- Organic Hemp
- Organic Linen
- Pineapple Fiber
- Ramie
- Sisal
- Soy
- Stone Nut
- Stone
- Seashell
- Vegetable Ivory
- Wax
- Wood
- Recycled Cotton
- Recycled Cotton (pre-consumer)
- Recycled Cotton (post-consumer)
- Recycled others
Mandatory percentage The percentage of each component present in the material. Number float Mandatory source_raw_material The source of the raw material used in the composition of the material (e.g. Eucalyptus (origin) → Tencel (fibre)) Text Optional part If the fibre component is specific to a part of the material (e.g. adhesive). Text Optional is_recycled To be selected if the material composition has a certain percentage of recycled input. Select - pre-consumer
- post-consumer
- recycled
- virgin
- not defined
Mandatory source_recycled_input If there is a recycled component, the source of the input needs to be selected (e.g. rPET from Post-Consumer PET). Text Optional steps step_type Origin of raw material Mandatory / auto-filled country Country of origin of raw material Select - Options: ISO country list Mandatory organization_name Text Optional street_address Text Optional postal_code Text Optional city Text Optional oar Text Optional gln Text Optional assigned_colour_category Assigned color category the material belongs to MultiSelect - beige
- black
- black & white
- blue
- burgundy
- brown
- coral
- indigo
- gold
- green
- grey
- khaki
- multicoloured
- navy
- nude
- off-white
- orange
- pink
- purple
- red
- rose
- silver
- taupe
- teal
- turquoise
- uncoloured
- white
- yellow
- other
Mandatory default=”other” pattern_type The type of pattern. Select - Options - No Pattern
- Heathered
- Marled Ombre
- Striped
- Abstract
- Checked
- Chevron
- Damask
- Dotted
- Floral
- Gingham
- Geometric
- Herringbone
- Houndstooth
- Melange
- Motifs for children
- Other pattern
- Paisley Stars
- Striped Tartan
Optional thumbnail The thumbnail image of the material. Image Optional material_weight Weight in g/m² of material. Only if Trim, Fabric or Leather Alternative Number float Optional material_percentage Number float Optional staple_fibre_length Only for fabrics and yarns can include an average Number float Optional category Type of material (fabric, yarn, trim ...) Select(auto-filled) - Options - trim
- yarn
- fabric
- leather
- leather_alternative
Mandatory material_type Specific type of a material depending on the chosen category of a material Select - Options (Depending on material category the options differ) -
Fabric
-
Non Woven
- Thermo-bonded
- Stitch-Bonded
- Padding
- Insulation
- Felt
-
Knit
- Bird's Eye
- Cable
- Cardigan
- Double Face
- Double Jersey
- Fleece
- French Terry
- Intarsia
- Interlock
- Jacquard Jersey
- Lacoste
- Milano Rib
- Pointelle
- Purl Knit
- Rachel
- Rib Knit
- Single Jersey
- Sliver Knit
- Tricot
- Velour
-
Woven
- Plain weave
- Basket weave
- Buckram
- Canvas
- Cambric
- Chambray
- Charmeuse
- Chiffon
- Chintz
- Corduroy
- Crepe
- Denim
- Dobby
- Double Face
- Duck
- Drill
- Flannel
- Gabardine
- Georgette
- Gingham
- Jacquard
- Khadi
- Muslin
- Organza
- Oxford
- Oxford Cloth
- Pique
- Poplin
- Ripstop
- Satin
- Sateen
- Taffeta
- Toile
- Twill
-
Lace
- Needle Lace
- Bobbin Lace
-
Non Woven
-
Yarn
- Boucle
- Chenille
- Cord
- Crimped
- Filament
- Fancy
- Melange
- Metallic
- Novelty
- One-ply
- Slub
- Stretch
- S-Twist
- Two-ply
- Textured
- Thread
- Z-Twist
-
Trims & Additionals
- Beads
- Braid
- Buckle
- Button
- Bra cups
- Bra wire
- Care label
- Collar stay
- De/ring
- Elastic
- Eyelet/grommet
- Fusing material
- Hook & Loop
- Interfacing
- Lace
- Label
- Patch
- Piping cord
- Ring
- Rivets
- Seam sealing tape
- Sequins
- Shoulder pad
- Slider
- String/Draw Cord
- Swivel hook
- Twill tape
- Velcro tape
- Wadding
- Zipper
-
Leather Alternative
- Non-Woven
- Non-Woven Dry Laid
- Non-Woven Wet Laid
- Non-Woven Spunlaid
- Non-Woven Meltblown
- Non-Woven Needle-punched
- Bonded
- Coated
- Naturally occurring
- Lab-grown
- Biotextile
Optional grade Leather grade
only available for leatherSelect - Options - Bonded
- Corrected
- Grain
- Full Grain
- Fur/Hair
- Split-Grain
- Top Grain
Optional species Only available for leather Select - Options - Bovine
- Fish
- Goat
- Pig
- Sheep
Optional species_other Only available for leather Text Optional pattern_application Only available for leather Select - Options - half
- whole
Optional thickness Thickness in mm
only available for leather alternativeNumber float Optional thickness_max Maximum thickness in mm.
only available for leathersNumber float Optional thickness_min Minimum thickness in mm.
only available for leathersNumber float Optional steps step_type Step type Select - Options - Production
- Spinning
- Tanning
- Pre Tanning
- Dyeing
- Finishing
- Printing
Mandatory country Select - Options: ISO country list Mandatory - with exceptions organization_name Text Optional street_address Text Optional postal_code Text Optional city Text Optional oar Facility's Open Apparel Registry number Text Optional gln Facility's Global Location Number Text Optional dyeing_process The dyeing process
If step_type is dyeingSelect - Options - Undyed
- Direct Dyed
- Top Dyed
- Yarn Dyed
- Dope Dyed
- Piece Dyed
Optional dye_stuff Select - Options - No dye stuff
- Acid dye
- Analine dye
- Azo dye
- Basic dye
- Chrome dye
- Direct dye
- Disperse dye
- Mordant dye
- Natural dye
- Pigment (natural)
- Pigment (biosynthetic)
- Pigment (synthetic)
- Reactive dye
- Vat Dye
- Sulfur Dyes
- Others
Optional printing_process The printing method used for the material Select - Options - No Printing
- Batik printed
- Digital printed
- Hand painted
- Inkjet printed
- Roller printed
- Screen printed
- Transfer printed
Optional print_stuff The print stuff required for the printing method.
If printing is “No Printing” this field is not mandatorySelect - Options - No Printing
- Batik printed
- Digital printed
- Hand painted
- Inkjet printed
- Roller printed
- Screen printed
- Transfer printed
Optional material_finishing The finishing type for material. MultiSelect - Options (differs if material category is leather) -
Finishing
- No finishes
- Unknown
-
Mechanical Finishing
- calendering
- embossing
- pre-shrinking
- permanent creasing
- sueding
- steaming
-
Chemical Finishing
- antibacterial finishing
- anti static finishing
- anti pilling
- coating
- coating (PU)
- coating (PVC)
- coating (Acrylic)
- colorfastness finishing
- crease resistance
- enzyme finishing
- flame retardancy
- matting agents
- milling agents
- mill washing
- natural oiling
- optical brighteners
- permanent press
- prepare for dyeing
- resins
- silicones
- softening agent
- soil release finishing
- stain resistance
- waxing
-
Finishing for leather
- No finishes
- Unknown
- coating
- coating (PU)
- coating (PVC)
- coating (Acrylic)
- fillers
- flame retardancy
- matting agents
- oil
- resins
- silicones
- softening agents
- waxes
Optional other_material_finishing The finishing type for material if none if the options fit Text Optional tannage Select - Options - Chromium
- Synthetic
- Vegetable
Optional pre_tannage Select - Options - Chromium
- Synthetic
- Vegetable
Optional water_properties Different options of water properties for the material. Select - Options - No Water Properties
- Water Proof
- Water Repellent
- Water Resistant
Optional certification certification_standard Select - Options (differs if material category is leather) -
certification
- BSCI (Business Social Compliance Initiative)
- Bluesign
- C2C Bronze (Cradle 2 Cradle)
- C2C Gold
- C2C Platinum
- C2C Silver
- EU Ecolabel
- Fairtrade
- FSC (Forest Stewardship Council)
- GOTS (Global Organic Textile Standard)
- GRS (Global Recycling Standard)
- Global Compact (remove)
- ILO (International Labour Organization)
- IVN (Internationale Verband der Naturtextilwirtschaft)
- IWTO (International Wool Textile Organization)
- OEKO-TEX STeP
- OEKO-TEX Standard 100
- OEKO-TEX_Made_In_Green
- OEKO-TEX_Detox_To_Zero
- OEKO-TEX_Eco_Passport
- OCS (Organic Content Standard)
- Other
- R.D:S (Responsible Down Standard)
- R.W.S (Responsible Wool Standard)
- SA8000
- UN Global Compact
-
certification leather
- C2C Bronze (Cradle 2 Cradle)
- C2C Gold
- C2C Platinium
- C2C Silver
- Ecopelle ICEC
- Global Recycling Standard (GRS)
- I.C.E.C. - Chemicals Management System
- I.C.E.C. - Eco-leathers
- I.C.E.C. - Environmental Management System
- I.C.E.C. - Leather traceability
- I.C.E.C. - Occupational Health and Safety Management System
- I.C.E.C. - Product certification for finished leathers
- I.C.E.C. - Quality Management System
- LEATHER STANDARD by OEKO-TEX®
- LWG (Leather Working Group) Bronze
- LWG (Leather Working Group) Gold
- LWG (Leather Working Group) Silver
- Naturleder IVN
- Other
- Recycled Claim Standard (RCS)
- UNIC code of conduct and social accountability
Optional certification_file File Optional biodegradability_certification certification Biodegradability certificate or standard Select - Options - CEC-L-103-12
- DIN EN ISO 11734
- DIN EN ISO 14593
- DIN EN ISO 9408
- ISO 11721-1
- ISO 7827
- ISO 846
- ISO 9887
- ISO 9888
- OECD 301 A
- OECD 301 D
- OECD 301 E
- OECD 301 F
- OECD 302 A
- OECD 302 B
- OECD 303 A
- OECD 310
- OECD 311
- en 13432
Optional biodegradability_certification_file File Optional Does the product comply with REACH? Compliance with chemical regulations or standards can determine recycling cycle Select - Options - Yes
- No
- I don't know
Optional Does the product comply with AFIRM? Compliance with chemical regulations or standards can determine recycling cycle Select - Options - Yes
- No
- I don't know
Optional Does the product comply with ZDHC MRSL? Compliance with chemical regulations or standards can determine recycling cycle Select - Options - Yes
- No
- I don't know
Optional -
Natural
