Your Company

👕 Garment Sizes

How clothing and shoe sizes appear in shopping data

When a person shares their shopping profile with you, the response from /storage/shopping can include their clothing and shoe sizes, and their body data. You can use these to preselect the right size on a product page, filter a catalogue, recommend items that fit, or run your own size advice.

Sizes Are Given per Scale

Clothing and shoes are sized differently for women and men, so every size category comes as an object with both scales:

"topSizes": { "women": ["m", "l"], "men": [] }

Use the scale that matches the product, not the person. Selling a men's shirt? Read topSizes.men. Selling a dress? Read dressSizes.women.

Both keys are always there. A scale the person didn't fill in, or doesn't share, is an empty list. Some categories currently only exist on one scale, like dresses or suits; the other scale is then always an empty list, so the format won't change if it's added later. We never convert one scale into the other.

Every value is a list, so you read every category the same way. Categories with a single size per person, such as trousers, are a list of one.

Which Sizes You Can Receive

FieldWhat it isWomen'sMen's
topSizesTops, shirts and sweaters["m", "l"], xxs to 5xl["l"], xs to 5xl
dressSizesDresses and skirts, EU[38, 40][]
suitSizesSuits, EU[][50]
dressShirtSizesDress shirts[][{ "collar": 39, "extraLongSleeves": true }]
trouserSizesJeans and trousers, in inches[{ "waist": 30, "length": 32 }][{ "waist": 33, "length": 34 }]
braSizesBra band and cup, EU[{ "band": 75, "cup": "c" }][]
shoeSizesShoes, EU[38, 39][43]

Letter sizes and bra cups are lower case. A trouser or bra size can have only one of its parts, for example { "waist": 33 } when the person didn't give a length. A dress shirt with extra-long sleeves is what's usually written as 39-7.

Picking a Scale

Use the scale that matches the product: women for women's clothing, men for men's. For a product that's sold for both, such as a unisex sneaker, start from the scale the person has sizes on. If they have sizes on both, start from the scale with the most sizes across the whole response.

Body Data

The shopping profile can also include the person's body data, which you can use for your own size advice:

FieldWhat it isExample
heightHeight in centimetres175
weightWeight in kilograms70
chestShapeChest relative to average"average"
waistShapeWaist relative to average"narrow"
hipShapeHips relative to average"wide"

We don't calculate sizes from the body data: the sizes you receive are always the ones the person filled in.

Some Sizes May Be Missing

People choose which of their clothing sizes they share, per scale. A category that isn't shared on either scale is left out of the response, so treat every size field as optional. When a field or scale is missing or empty, show your normal size picker without a preselection. Shoe sizes are always shared when filled in.

Example Response

{
    "height": 168,
    "weight": 61,
    "topSizes": { "women": ["m", "l"], "men": [] },
    "trouserSizes": { "women": [{ "waist": 30, "length": 32 }], "men": [] },
    "braSizes": { "women": [{ "band": 75, "cup": "c" }], "men": [] },
    "shoeSizes": { "women": [39], "men": [] }
}

This person shares their women's tops, trouser, bra and shoe sizes. They don't share a dress size, so dressSizes is missing.

Sizes in Raw Data

If the person gave you consent to read their raw shopping data (/storage/shopping/raw), you get the sizes as they're stored, one field per scale and part, such as topLetterSizesWomen: ["m"], trouserWaistMen: 33 and trouserLengthMen: 34.

TypeScript Types

type PerScale<T> = { women: T[]; men: T[] };

type LetterSize =
    'xxs' | 'xs' | 's' | 'm' | 'l' | 'xl' | 'xxl' | '3xl' | '4xl' | '5xl';
type BodyShape = 'narrow' | 'average' | 'wide';

type ShoppingSizes = {
    topSizes?: PerScale<LetterSize>;
    dressSizes?: PerScale<number>;
    suitSizes?: PerScale<number>;
    dressShirtSizes?: PerScale<{ collar: number; extraLongSleeves: boolean }>;
    trouserSizes?: PerScale<{ waist?: number; length?: number }>;
    braSizes?: PerScale<{ band?: number; cup?: string }>;
    shoeSizes?: PerScale<number>;
    height?: number;
    weight?: number;
    chestShape?: BodyShape;
    waistShape?: BodyShape;
    hipShape?: BodyShape;
};

On this page