Skip to content

The Size Object

The size field uses a structured format with scale, name and optional type fields:

Field Type Required Description
scale string Yes The sizing system (e.g. S-M-L, US, WAIST).
See the Sizing Scales section for more details.
name string Yes The specific size value within that scale (e.g. M, 8, 35.5, One Size).
See the Sizing Scales section for examples.
type string No The category's sizing type, required only when multiple categories have overlapping scale/name combinations.

Default Size Behavior

If scale and name are not provided and the category has a default_size, the default will be applied automatically.

Type Field Requirement

The type field is currently required for shoe categories with overlapping sizes between KidsShoeSize and YouthShoeSize. These categories have overlapping values when using US or UK scales.

Sizing Scales

Scale Description Values
WAIST Waist measurement in inches for women's jeans, pants, shorts and skirts Sizes between 23 and 52
S-M-L Small, Medium and Large clothing sizes P, XXS, XS, S, M, L, XL, XXL, 0X, 1X, 2X, 3X, 4X, 5X
US Clothing and shoe sizes (US system) Clothing: Sizes between 0 and 32
Shoes: Sizes between 4 and 12 with half sizes
EUR Shoe sizes (European system) Sizes between 16 and 43 with half sizes
UK Shoe sizes (UK system) Sizes between 1 and 14 with half sizes
JP Shoe sizes (Japanese system) Sizes between 9 and 25 with half sizes
IN Foot length in inches for women's shoes Sizes between 8 1/8 and 11 with fractions
CM Height measurements in centimeters for boys and girls clothing Sizes between 50 and 175
OTHER Category specific sizing for kids items Fits all, Fits all (infants), Fits all (tots), Fits all (kids), Fits all (youth)
Fits All One Size fits all (accessories and handbags) One Size

Women's Bottoms Sizing

WAIST sizing should be used for women's Jeans, Pants, Shorts and Skirts (and their subcategories).

How to Determine Valid Sizes

Workflow:

  1. Locate the target category in the Categories API response and navigate to its root category group
  2. Identify valid size combinations from the allowed_sizes object
  3. Use a valid scale and name combination when creating items

Example Categories API Response:

{
  "id": 66,
  "name": "Handbags",
  "gender": "women",
  "sizing_type": "WomenHandbagSize",
  "allowed_sizes": {
    "Fits All": ["One Size"]
  },
  "default_size": {
    "scale": "Fits All",
    "name": "One Size"
  },
  "children": [...]
}

Understanding allowed_sizes:

The allowed_sizes object shows which sizing systems and values are valid for a category. In the example above:

  • Fits All is a valid scale value
  • One Size is a valid name value within the Fits All scale
  • The size request would be: {"scale": "Fits All", "name": "One Size"}

Examples

Only size related fields are shown in the examples below. See List an Item for complete request examples.

{
  "title": "Leather Clutch",
  "brand_id": 75,
  "category_id": 980,
  ...
  // size omitted - uses default Fits All / One Size
}


{
  "title": "Women's Silk Blouse",
  "brand_id": 150,
  "category_id": 1070,
  "size": {
    "scale": "S-M-L",
    "name": "M"
  },
  ...
}


{
  "title": "Women's Denim Jeans",
  "brand_id": 180,
  "category_id": 356,
  "size": {
    "scale": "WAIST",
    "name": "28"
  },
  ...
}


{
  "title": "Kid's Sneakers",
  "brand_id": 200,
  "category_id": 288,
  "size": {
    "scale": "US",
    "name": "2",
    "type": "KidsShoeSize"
  },
  ...
}