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 3.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
    company Owner of product Text Mandatory
  • Variation
    Attribute Data point description Type Requirements
    name Variation name of product (e.g. “black”) Text Mandatory
    product_name Name on product sites to be displayed (e.g “Slim Summer Shirt - black”.) Text Mandatory
    description 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
    season The season in which the product belongs to; spring/summer, autumn/winter. Text Optional
    year The year in which the product is produced Number int Mandatory
    brand The fashion brand Text Mandatory
    brand_description Description of the brand written by the brand Text Optional
    parent_company A company owning several brands and is parent company of the brand. Text Optional
    logo Brand logo Image Optional
    brand_image Image of brand (in addition to logo) Image Optional
    market_segment Market segment of the product Select - Options
    • mass-market
    • mid-price
    • premium
    • luxury
    Optional
    product_category Category of product; e.g apparel, footwear, accessories Select - Options
    • 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
    product_image Images of the product Image Mandatory, one or more
    weight Weight of the total product Number float Optional
    weight_unit Unit of measurement Select - Options
    • g
    • kg
    • oz
    • lb
    Optional
    colourway Colour of product as named by the brand (e.g. Midnight blue) Text Mandatory
    colours Colour group 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
    Optional
    size Size of product Text Mandatory
    size_metric Which size metric is applied; EU, US etc. Select - Options
    • EU
    • FR
    • IT
    • UK
    • International
    Mandatory
    price Price of product Number float Optional
    price_currency Which currency is used Select - Options
    • USD
    • EUR
    • GBP
    Optional
    certification
    certification_type 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
    water_properties Water properties on the finished product. Select - Options
    • No Water properties
    • Waterproof
    • Water Repellent
    • Water Resistant
    Optional
    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
    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
    strategy_description Description of the circular design strategy used written by the brand Text Optional
    service
    name Present which service the brand offers to prolong the life of the product (repair, resell, rental, redesign, take-back system - list of choices in old schema) Text Optional
    service_type Select - Options
    • Other
    • Repair
    • Resell
    • Rental
    • Redesign
    • Take back for recycling
    • Take back for reuse
    Mandatory
    description Description of service written by the brand Text 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_image Image of care icons Image Optional, zero or more
    sustainability_statement Sustainability statement by the brand written by the brand Text Optional
    sustainability_guide_image Sustainability image by the brand Image Optional
    production_description Description of production of the garment written by the brand “e.g produced with love in Berlin“ Text Optional
    production_image Image of the production Image Optional
    product_steps
    step_type The step type Select - Options
    • Full Garment Supply
    • Cut, Make, Trim
    • Embellishing
    • Laundry
    • Packaging & Shipping
    • Dyeing
    • Finishing
    • Printing
    Mandatory
    country Select - Options: ISO country list Mandatory
    company_name Text Optional
    street Text Optional
    postal Text Optional
    city Text Optional
    oar Text Optional
    dyeing_process The dyeing process

    If step_type is dyeing
    Text Mandatory
    dye_stuff If step_type is dyeing Text Mandatory
    printing_process The printing method used for the material.

    If step_type is printing
    Text Mandatory
    print_stuff The print stuff required for the printing method.

    If step_type is printing
    Text Mandatory
    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. Checkbox Mandatory (default false)
    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
    country Country of origin of raw material Select - Options: ISO country list Mandatory
    company_name Text Optional
    street Text Optional
    postal Text Optional
    city Text Optional
    oar Text Optional
    colours The colour group of the material. Select - 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
    Optional, one or more
    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
    weight Weight in g/m² of material. Only if Trim, Fabric or Leather Alternative Number float Optional
    consumption Number float Optional
    consumption_unit Select - Options
    • sqm
    • m
    • sqft
    • piece
    • pack
    • kg
    Optional
    staple_fibre_length Only for fabrics and yarns Number float Optional
    technical_data_sheet File Optional
    category Type of material (fabric, yarn, trim ...) needed for validating material_type
    trim, yarn, fabric, leather, alternative_leather
    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
    • 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 leather
    Select - 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
    • No pattern
    • Embossing
    • Embroidery
    • Etching
    • Laser engraving
    • Other
    • Painting
    • Perforation
    • Printing
    Optional
    thickness Thickness in mm
    only available for leather alternative
    Number float Optional
    thickness_max Maximum thickness in mm.
    only available for leathers
    Number float Optional
    thickness_min Minimum thickness in mm.
    only available for leathers
    Number float Optional
    steps
    step_type Step type Select - Options
    • Production
    • Spinning
    • Tanning
    • Pre Tanning
    • Dyeing
    • Finishing
    • Printing
    Mandatory
    country If dyeing is “Undyed” or “natural” this field is not mandatory
    If printing is “no printing” this field is not mandatory
    If finishing is “no finishes” or “unknown” this field is not mandatory
    Select - Options: ISO country list Mandatory
    company_name Text Optional
    street Text Optional
    postal Text Optional
    city Text Optional
    oar Text Optional
    dyeing_process The dyeing process
    If step_type is dyeing
    Select - Options (differs if material category is leather)
    • Dyeing process
      • Undyed
      • Direct Dyed
      • Top Dyed
      • Yarn Dyed
      • Dope Dyed
      • Piece Dyed
    • Dyeing process for leather
      • Natural
      • Aniline
      • Dyed through
      • Pigmented
      • Top Coat
    Mandatory
    dye_stuff If dyeing is “Undyed” or “Natural” this field is not mandatory 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
    Mandatory
    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
    Mandatory
    print_stuff The print stuff required for the printing method.
    If printing is “No Printing” this field is not mandatory
    Select - Options
    • No Printing
    • Batik printed
    • Digital printed
    • Hand painted
    • Inkjet printed
    • Roller printed
    • Screen printed
    • Transfer printed
    Mandatory
    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
    Mandatory
    other_material_finishing The finishing type for material if none if the options fit Text Mandatory
    if material_finishing not set
    tannage Only available for leather Select - Options
    • Chromium
    • Synthetic
    • Vegetable
    Optional
    pre_tannage Only available for leather 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
    social_environmental_certification
    certification 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
    social_environmental_certification_file File Optional
    material_safety_data_sheet
    certification Select - Options
    • MSDS Dyeing
    • MSDS Finishing
    • MSDS Material Origin
    • MSDS Spinning
    Optional
    material_safety_data_sheet_file File Optional
    biodegradability_certification
    certification Biodegradability certificate 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
    chemical_compliance Chemical contents are in accordance to chemical banned lists of a certain standard. Select - Options
    • C2C
    • Fairtrade Prohibited Material List
    • Global Recycling Standard
    • IVN
    • REACH
    • ZDHC
    Optional
    other_chemical_compliance Text Optional
If you like your products to be connected and would like to learn more, please reach out.

circular.fashion - the tech and consulting support for your circular business.

circular.fashion develops software and services for circular design and closed loop recycling that enable a transparent flow of information between material suppliers, fashion brands, consumers and recyclers. - Go to website

Go to website