Last update 03/03/2023

Manage Size Chart

Note:
It is available only for Brazil and Mexico.

The size guide allows buyers to have a better experience when choosing their product, thus avoiding size changes and/or claims; so consider developing this functionality to serve fashion sellers. See more about What should I know about the size chart?.

Experience Goals

  • Ensure that fashion publications are always created with a size chart.
  • Ensure that products are published with the right size chart.
  • Seek to make this task as easy as possible so that we do not have dropouts by users when choosing or creating a size chart.
  • Standardize the options for the size chart in US, US-M, US-F, EU, UK and manufacturer size.

Available domain to create size chart from:

Footwear:

  • SNEAKERS
  • BOOTS_AND_BOOTIES
  • LOAFERS_AND_OXFORDS
  • FOOTBALL_SHOES
  • SANDALS_AND_CLOGS

Create size chart

It's possible to create a manufacture size chart. To create a size chart you should define names, gender, main attributes, measurements, secondary attributes, etc.


Note:
Remember the technical sheet received when you upload the attribute required for the template, since this technical sheet will have the attributes that you must send in the size guide creation POST. If you send an attribute that is not in the file, it will return an error.

Additionally, this data sheet also indicates:

  • The data types (text, number unit, list, etc).
  • The attributes that have the main_attribute_candidate tag (Candidates to be main size) must send at least one as main_atributte.
  • Attributes with the required tag are required, except for those that also contain the grid_filter tag.
  • The attributes that have the grid_filter tag must be loaded at the general size guide level and not at the rows level.
  • At the rows level, you will have to send those attributes that only have the required tag and at least one that has the main_attribute_candidate tag.

Ranger attributes

Specific or custom size charts support the use of measurement ranges, sending FOOT_LENGTH and FOOT_LENGTH_TO attributes for each of the rows in the body. The use of attributes will depend on the configuration of the data sheet.



domain_id: define this type of domain for footwear.

main attributes: it is filled according to the rule that the size guide has and will represent the main size that will be displayed in the publication (column that will be the main size). One of the following options is mandatory: US_SIZE (US), M_US_SIZE (US-M), F_US_SIZE (US-F), EU_SIZE (EU), UK_SIZE (UK) or MANUFACTURER_SIZE. .

The first column of the size chart will determine what goes in the picker (descriptive detail of the size). This column can be set by the seller to change what we want to show as the size description. The first column of the size chart will always be identified under the id of the SIZE attribute.



Secondary size: optional and represents other standard, local or manufacturer sizes.


Rows: sizes related to the size chart.




Request:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" https://api.mercadolibre.com/catalog/charts

Example:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' https://api.mercadolibre.com/catalog/charts -d 
'{
    "names": {
        "CBT": "Woman Sneakers",
        "MLB": "Woman Sneakers",
        "MLM": "Woman Sneakers"
    },
    "domain_id": "SNEAKERS",
    "site_id": "CBT",
    "type": "SPECIFIC",
    "main_attribute": {
        "attributes": [
            {
                "site_id": "CBT",
                "id": "F_US_SIZE"
            },
            {
                "site_id": "MLM",
                "id": "F_US_SIZE"
            },
            {
                "site_id": "MLB",
                "id": "F_US_SIZE"
            }
        ]
    },
    "secondary_attribute": {
        "attributes": [
            {
                "site_id": "CBT",
                "id": "EU_SIZE"
            },
            {
                "site_id": "MLM",
                "id": "MX_SIZE"
            },
            {
                "site_id": "MLB",
                "id": "BR_SIZE"
            }
        ]
    },
    "attributes": [
        {
            "id": "GENDER",
            "values": [
                {
                    "id": "339665",
                    "name": "Woman"
                }
            ]
        }
    ],
    "rows": [
        {
            "id": "461058:1",
            "sites": [
                "MLM",
                "MLB"
            ],
            "attributes": [
                {
                    "id": "FOOT_LENGTH",
                    "values": [
                        {
                            "name": "21.5 cm",
                            "struct": {
                                "number": 21.5,
                                "unit": "cm"
                            }
                        }
                    ]
                },
                {
                    "id": "FOOT_LENGTH_TO",
                    "values": [
                        {
                            "name": "22.5 cm",
                            "struct": {
                                "number": 22.5,
                                "unit": "cm"
                            }
                        }
                    ]
                },
                {
                    "id": "BR_SIZE",
                    "values": [
                        {
                            "name": "34 BR",
                            "struct": {
                                "number": 34.0,
                                "unit": "BR"
                            }
                        }
                    ]
                },
                {
                    "id": "MX_SIZE",
                    "values": [
                        {
                            "name": "5 MX",
                            "struct": {
                                "number": 5.0,
                                "unit": "MX"
                            }
                        }
                    ]
                },
                {
                    "id": "F_US_SIZE",
                    "values": [
                        {
                            "name": "5 US",
                            "struct": {
                                "number": 5.0,
                                "unit": "US"
                            }
                        }
                    ]
                },
                {
                    "id": "EU_SIZE",
                    "values": [
                        {
                            "name": "36 EU",
                            "struct": {
                                "number": 36.0,
                                "unit": "EU"
                            }
                        }
                    ]
                },
                {
                    "id": "UK_SIZE",
                    "values": [
                        {
                            "name": "3 UK",
                            "struct": {
                                "number": 3.0,
                                "unit": "UK"
                            }
                        }
                    ]
                }
            ]
        },
        {
            "id": "461058:2",
            "sites": [
                "MLM",
                "MLB"
            ],
            "attributes": [
                {
                    "id": "FOOT_LENGTH",
                    "values": [
                        {
                            "name": "23 cm",
                            "struct": {
                                "number": 23.0,
                                "unit": "cm"
                            }
                        }
                    ]
                },
                {
                    "id": "BR_SIZE",
                    "values": [
                        {
                            "name": "36 BR",
                            "struct": {
                                "number": 36.0,
                                "unit": "BR"
                            }
                        }
                    ]
                },
                {
                    "id": "MX_SIZE",
                    "values": [
                        {
                            "name": "6 MX",
                            "struct": {
                                "number": 6.0,
                                "unit": "MX"
                            }
                        }
                    ]
                },
                {
                    "id": "F_US_SIZE",
                    "values": [
                        {
                            "name": "6 US",
                            "struct": {
                                "number": 6.0,
                                "unit": "US"
                            }
                        }
                    ]
                },
                {
                    "id": "EU_SIZE",
                    "values": [
                        {
                            "name": "37 EU",
                            "struct": {
                                "number": 37.0,
                                "unit": "EU"
                            }
                        }
                    ]
                },
                {
                    "id": "UK_SIZE",
                    "values": [
                        {
                            "name": "4 UK",
                            "struct": {
                                "number": 4.0,
                                "unit": "UK"
                            }
                        }
                    ]
                }
            ]
        },
        {
            "id": "461058:3",
            "sites": [
                "MLM",
                "MLB"
            ],
            "attributes": [
                {
                    "id": "FOOT_LENGTH",
                    "values": [
                        {
                            "name": "24 cm",
                            "struct": {
                                "number": 24.0,
                                "unit": "cm"
                            }
                        }
                    ]
                },
                {
                    "id": "FOOT_LENGTH_TO",
                    "values": [
                        {
                            "name": "25 cm",
                            "struct": {
                                "number": 25.0,
                                "unit": "cm"
                            }
                        }
                    ]
                },
                {
                    "id": "BR_SIZE",
                    "values": [
                        {
                            "name": "37 BR",
                            "struct": {
                                "number": 37.0,
                                "unit": "BR"
                            }
                        }
                    ]
                },
                {
                    "id": "MX_SIZE",
                    "values": [
                        {
                            "name": "7 MX",
                            "struct": {
                                "number": 7.0,
                                "unit": "MX"
                            }
                        }
                    ]
                },
                {
                    "id": "F_US_SIZE",
                    "values": [
                        {
                            "name": "7 US",
                            "struct": {
                                "number": 7.0,
                                "unit": "US"
                            }
                        }
                    ]
                },
                {
                    "id": "EU_SIZE",
                    "values": [
                        {
                            "name": "38 EU",
                            "struct": {
                                "number": 38.0,
                                "unit": "EU"
                            }
                        }
                    ]
                },
                {
                    "id": "UK_SIZE",
                    "values": [
                        {
                            "name": "5 UK",
                            "struct": {
                                "number": 5.0,
                                "unit": "UK"
                            }
                        }
                    ]
                }
            ]
        }
    ]
}'

Response: 201 Created

{
   "id": "469460",
   "names": {
       "CBT": "Woman Sneakers 2",
       "MLB": "Woman Sneakers 2",
       "MLM": "Woman Sneakers 2"
   },
   "domain_id": "SNEAKERS",
   "site_id": "CBT",
   "type": "SPECIFIC",
   "seller_id": 1173213765,
   "main_attribute": {
       "attributes": [
           {
               "site_id": "CBT",
               "id": "F_US_SIZE"
           },
           {
               "site_id": "MLM",
               "id": "F_US_SIZE"
           },
           {
               "site_id": "MLB",
               "id": "F_US_SIZE"
           }
       ]
   },
   "secondary_attribute": {
       "attributes": [
           {
               "site_id": "CBT",
               "id": "EU_SIZE"
           },
           {
               "site_id": "MLM",
               "id": "MX_SIZE"
           },
           {
               "site_id": "MLB",
               "id": "BR_SIZE"
           }
       ]
   },
   "attributes": [
       {
           "id": "GENDER",
           "values": [
               {
                   "id": "339665",
                   "name": "Woman"
               }
           ]
       }
   ],
   "rows": [
       {
           "id": "469460:1",
           "sites": [
               "MLM",
               "MLB"
           ],
           "attributes": [
               {
                   "id": "FOOT_LENGTH",
                   "values": [
                       {
                           "name": "21.5 cm",
                           "struct": {
                               "number": 21.5,
                               "unit": "cm"
                           }
                       }
                   ]
               },
               {
                   "id": "FOOT_LENGTH_TO",
                   "values": [
                       {
                           "name": "22.5 cm",
                           "struct": {
                               "number": 22.5,
                               "unit": "cm"
                           }
                       }
                   ]
               },
               {
                   "id": "BR_SIZE",
                   "values": [
                       {
                           "name": "34 BR",
                           "struct": {
                               "number": 34.0,
                               "unit": "BR"
                           }
                       }
                   ]
               },
               {
                   "id": "MX_SIZE",
                   "values": [
                       {
                           "name": "5 MX",
                           "struct": {
                               "number": 5.0,
                               "unit": "MX"
                           }
                       }
                   ]
               },
               {
                   "id": "F_US_SIZE",
                   "values": [
                       {
                           "name": "5 US",
                           "struct": {
                               "number": 5.0,
                               "unit": "US"
                           }
                       }
                   ]
               },
               {
                   "id": "EU_SIZE",
                   "values": [
                       {
                           "name": "36 EU",
                           "struct": {
                               "number": 36.0,
                               "unit": "EU"
                           }
                       }
                   ]
               },
               {
                   "id": "UK_SIZE",
                   "values": [
                       {
                           "name": "3 UK",
                           "struct": {
                               "number": 3.0,
                               "unit": "UK"
                           }
                       }
                   ]
               }
           ]
       },
       {
           "id": "469460:2",
           "sites": [
               "MLM",
               "MLB"
           ],
           "attributes": [
               {
                   "id": "FOOT_LENGTH",
                   "values": [
                       {
                           "name": "23 cm",
                           "struct": {
                               "number": 23.0,
                               "unit": "cm"
                           }
                       }
                   ]
               },
               {
                   "id": "BR_SIZE",
                   "values": [
                       {
                           "name": "36 BR",
                           "struct": {
                               "number": 36.0,
                               "unit": "BR"
                           }
                       }
                   ]
               },
               {
                   "id": "MX_SIZE",
                   "values": [
                       {
                           "name": "6 MX",
                           "struct": {
                               "number": 6.0,
                               "unit": "MX"
                           }
                       }
                   ]
               },
               {
                   "id": "F_US_SIZE",
                   "values": [
                       {
                           "name": "6 US",
                           "struct": {
                               "number": 6.0,
                               "unit": "US"
                           }
                       }
                   ]
               },
               {
                   "id": "EU_SIZE",
                   "values": [
                       {
                           "name": "37 EU",
                           "struct": {
                               "number": 37.0,
                               "unit": "EU"
                           }
                       }
                   ]
               },
               {
                   "id": "UK_SIZE",
                   "values": [
                       {
                           "name": "4 UK",
                           "struct": {
                               "number": 4.0,
                               "unit": "UK"
                           }
                       }
                   ]
               }
           ]
       },
       {
           "id": "469460:3",
           "sites": [
               "MLM",
               "MLB"
           ],
           "attributes": [
               {
                   "id": "FOOT_LENGTH",
                   "values": [
                       {
                           "name": "24 cm",
                           "struct": {
                               "number": 24.0,
                               "unit": "cm"
                           }
                       }
                   ]
               },
               {
                   "id": "FOOT_LENGTH_TO",
                   "values": [
                       {
                           "name": "25 cm",
                           "struct": {
                               "number": 25.0,
                               "unit": "cm"
                           }
                       }
                   ]
               },
               {
                   "id": "BR_SIZE",
                   "values": [
                       {
                           "name": "37 BR",
                           "struct": {
                               "number": 37.0,
                               "unit": "BR"
                           }
                       }
                   ]
               },
               {
                   "id": "MX_SIZE",
                   "values": [
                       {
                           "name": "7 MX",
                           "struct": {
                               "number": 7.0,
                               "unit": "MX"
                           }
                       }
                   ]
               },
               {
                   "id": "F_US_SIZE",
                   "values": [
                       {
                           "name": "7 US",
                           "struct": {
                               "number": 7.0,
                               "unit": "US"
                           }
                       }
                   ]
               },
               {
                   "id": "EU_SIZE",
                   "values": [
                       {
                           "name": "38 EU",
                           "struct": {
                               "number": 38.0,
                               "unit": "EU"
                           }
                       }
                   ]
               },
               {
                   "id": "UK_SIZE",
                   "values": [
                       {
                           "name": "5 UK",
                           "struct": {
                               "number": 5.0,
                               "unit": "UK"
                           }
                       }
                   ]
               }
           ]
       }
   ]
}

Validation size chart

This method allows validating the structure of the chart to be created, identifying that it is consistent.


Request:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" https://api.mercadolibre.com/catalog/charts/validation

Example:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' https://api.mercadolibre.com/catalog/charts/validation 
-d 
'{
    "names": {
        "CBT": "Woman Sneaker Validation",
        "MLB": "Woman Sneakers Validation",
        "MLM": "Woman Sneakers Validation"
    },
    "domain_id": "SNEAKERS",
    "site_id": "CBT",
    "type": "SPECIFIC",
    "main_attribute": {
        "attributes": [
            {
                "site_id": "CBT",
                "id": "F_US_SIZE"
            },
            {
                "site_id": "MLM",
                "id": "F_US_SIZE"
            },
            {
                "site_id": "MLB",
                "id": "F_US_SIZE"
            }
        ]
    },
    "secondary_attribute": {
        "attributes": [
            {
                "site_id": "CBT",
                "id": "EU_SIZE"
            },
            {
                "site_id": "MLM",
                "id": "MX_SIZE"
            },
            {
                "site_id": "MLB",
                "id": "BR_SIZE"
            }
        ]
    },
    "attributes": [
        {
            "id": "GENDER",
            "values": [
                {
                    "id": "339665",
                    "name": "Woman"
                }
            ]
        }
    ],
    "rows": [
        {
            "id": "461058:1",
            "sites": [
                "MLM",
                "MLB"
            ],
            "attributes": [
                {
                    "id": "FOOT_LENGTH",
                    "values": [
                        {
                            "name": "21.5 cm",
                            "struct": {
                                "number": 21.5,
                                "unit": "cm"
                            }
                        }
                    ]
                },
                {
                    "id": "FOOT_LENGTH_TO",
                    "values": [
                        {
                            "name": "22.5 cm",
                            "struct": {
                                "number": 22.5,
                                "unit": "cm"
                            }
                        }
                    ]
                },
                {
                    "id": "BR_SIZE",
                    "values": [
                        {
                            "name": "34 BR",
                            "struct": {
                                "number": 34.0,
                                "unit": "BR"
                            }
                        }
                    ]
                },
                {
                    "id": "MX_SIZE",
                    "values": [
                        {
                            "name": "5 MX",
                            "struct": {
                                "number": 5.0,
                                "unit": "MX"
                            }
                        }
                    ]
                },
                {
                    "id": "F_US_SIZE",
                    "values": [
                        {
                            "name": "5 US",
                            "struct": {
                                "number": 5.0,
                                "unit": "US"
                            }
                        }
                    ]
                },
                {
                    "id": "EU_SIZE",
                    "values": [
                        {
                            "name": "36 EU",
                            "struct": {
                                "number": 36.0,
                                "unit": "EU"
                            }
                        }
                    ]
                },
                {
                    "id": "UK_SIZE",
                    "values": [
                        {
                            "name": "3 UK",
                            "struct": {
                                "number": 3.0,
                                "unit": "UK"
                            }
                        }
                    ]
                }
            ]
        },
        {
            "id": "461058:2",
            "sites": [
                "MLM",
                "MLB"
            ],
            "attributes": [
                {
                    "id": "FOOT_LENGTH",
                    "values": [
                        {
                            "name": "23 cm",
                            "struct": {
                                "number": 23.0,
                                "unit": "cm"
                            }
                        }
                    ]
                },
                {
                    "id": "BR_SIZE",
                    "values": [
                        {
                            "name": "36 BR",
                            "struct": {
                                "number": 36.0,
                                "unit": "BR"
                            }
                        }
                    ]
                },
                {
                    "id": "MX_SIZE",
                    "values": [
                        {
                            "name": "6 MX",
                            "struct": {
                                "number": 6.0,
                                "unit": "MX"
                            }
                        }
                    ]
                },
                {
                    "id": "F_US_SIZE",
                    "values": [
                        {
                            "name": "6 US",
                            "struct": {
                                "number": 6.0,
                                "unit": "US"
                            }
                        }
                    ]
                },
                {
                    "id": "EU_SIZE",
                    "values": [
                        {
                            "name": "37 EU",
                            "struct": {
                                "number": 37.0,
                                "unit": "EU"
                            }
                        }
                    ]
                },
                {
                    "id": "UK_SIZE",
                    "values": [
                        {
                            "name": "4 UK",
                            "struct": {
                                "number": 4.0,
                                "unit": "UK"
                            }
                        }
                    ]
                }
            ]
        },
        {
            "id": "461058:3",
            "sites": [
                "MLM",
                "MLB"
            ],
            "attributes": [
                {
                    "id": "FOOT_LENGTH",
                    "values": [
                        {
                            "name": "24 cm",
                            "struct": {
                                "number": 24.0,
                                "unit": "cm"
                            }
                        }
                    ]
                },
                {
                    "id": "FOOT_LENGTH_TO",
                    "values": [
                        {
                            "name": "25 cm",
                            "struct": {
                                "number": 25.0,
                                "unit": "cm"
                            }
                        }
                    ]
                },
                {
                    "id": "BR_SIZE",
                    "values": [
                        {
                            "name": "37 BR",
                            "struct": {
                                "number": 37.0,
                                "unit": "BR"
                            }
                        }
                    ]
                },
                {
                    "id": "MX_SIZE",
                    "values": [
                        {
                            "name": "7 MX",
                            "struct": {
                                "number": 7.0,
                                "unit": "MX"
                            }
                        }
                    ]
                },
                {
                    "id": "F_US_SIZE",
                    "values": [
                        {
                            "name": "7 US",
                            "struct": {
                                "number": 7.0,
                                "unit": "US"
                            }
                        }
                    ]
                },
                {
                    "id": "EU_SIZE",
                    "values": [
                        {
                            "name": "38 EU",
                            "struct": {
                                "number": 38.0,
                                "unit": "EU"
                            }
                        }
                    ]
                },
                {
                    "id": "UK_SIZE",
                    "values": [
                        {
                            "name": "5 UK",
                            "struct": {
                                "number": 5.0,
                                "unit": "UK"
                            }
                        }
                    ]
                }
            ]
        }
    ]
}'\'''

Response:

{
   "result": true
}

Consult size chart

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog/charts/$CHART_ID

Example

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog/charts/467833

Response: 200 ok

{
   "id": "467833",
   "names": {
       "CBT": "Woman Sneakers"
   },
   "domain_id": "SNEAKERS",
   "site_id": "CBT",
   "type": "SPECIFIC",
   "seller_id": 1173213765,
   "main_attribute_id": "F_US_SIZE",
   "secondary_attribute_id": "EU_SIZE",
   "attributes": [
       {
           "id": "GENDER",
           "name": "Gender",
           "values": [
               {
                   "id": "339665",
                   "name": "Woman"
               }
           ]
       }
   ],
   "rows": [
       {
           "id": "467833:1",
           "attributes": [
               {
                   "id": "SIZE",
                   "name": "Size",
                   "values": [
                       {
                           "name": "5 US",
                           "struct": {
                               "number": 5.0,
                               "unit": "US"
                           }
                       }
                   ]
               },
               {
                   "id": "FOOT_LENGTH",
                   "name": "Foot length",
                   "values": [
                       {
                           "name": "21.5 cm",
                           "struct": {
                               "number": 21.5,
                               "unit": "cm"
                           }
                       },
                       {
                           "name": "21.5 cm",
                           "struct": {
                               "number": 21.5,
                               "unit": "cm"
                           }
                       }
                   ]
               },
               {
                   "id": "FOOT_LENGTH_TO",
                   "name": "Foot length to",
                   "values": [
                       {
                           "name": "22.5 cm",
                           "struct": {
                               "number": 22.5,
                               "unit": "cm"
                           }
                       },
                       {
                           "name": "22.5 cm",
                           "struct": {
                               "number": 22.5,
                               "unit": "cm"
                           }
                       }
                   ]
               },
               {
                   "id": "BR_SIZE",
                   "name": "BR",
                   "values": [
                       {
                           "name": "34 BR",
                           "struct": {
                               "number": 34.0,
                               "unit": "BR"
                           }
                       }
                   ]
               },
               {
                   "id": "MX_SIZE",
                   "name": "MX",
                   "values": [
                       {
                           "name": "5 MX",
                           "struct": {
                               "number": 5.0,
                               "unit": "MX"
                           }
                       }
                   ]
               },
               {
                   "id": "F_US_SIZE",
                   "name": "US-F",
                   "values": [
                       {
                           "name": "5 US",
                           "struct": {
                               "number": 5.0,
                               "unit": "US"
                           }
                       }
                   ]
               },
               {
                   "id": "EU_SIZE",
                   "name": "EU",
                   "values": [
                       {
                           "name": "36 EU",
                           "struct": {
                               "number": 36.0,
                               "unit": "EU"
                           }
                       }
                   ]
               },
               {
                   "id": "UK_SIZE",
                   "name": "UK",
                   "values": [
                       {
                           "name": "3 UK",
                           "struct": {
                               "number": 3.0,
                               "unit": "UK"
                           }
                       }
                   ]
               }
           ]
       },
       {
           "id": "467833:2",
           "attributes": [
               {
                   "id": "SIZE",
                   "name": "Size",
                   "values": [
                       {
                           "name": "6 US",
                           "struct": {
                               "number": 6.0,
                               "unit": "US"
                           }
                       }
                   ]
               },
               {
                   "id": "FOOT_LENGTH",
                   "name": "Foot length",
                   "values": [
                       {
                           "name": "23 cm",
                           "struct": {
                               "number": 23.0,
                               "unit": "cm"
                           }
                       },
                       {
                           "name": "23 cm",
                           "struct": {
                               "number": 23.0,
                               "unit": "cm"
                           }
                       }
                   ]
               },
               {
                   "id": "BR_SIZE",
                   "name": "BR",
                   "values": [
                       {
                           "name": "36 BR",
                           "struct": {
                               "number": 36.0,
                               "unit": "BR"
                           }
                       }
                   ]
               },
               {
                   "id": "MX_SIZE",
                   "name": "MX",
                   "values": [
                       {
                           "name": "6 MX",
                           "struct": {
                               "number": 6.0,
                               "unit": "MX"
                           }
                       }
                   ]
               },
               {
                   "id": "F_US_SIZE",
                   "name": "US-F",
                   "values": [
                       {
                           "name": "6 US",
                           "struct": {
                               "number": 6.0,
                               "unit": "US"
                           }
                       }
                   ]
               },
               {
                   "id": "EU_SIZE",
                   "name": "EU",
                   "values": [
                       {
                           "name": "37 EU",
                           "struct": {
                               "number": 37.0,
                               "unit": "EU"
                           }
                       }
                   ]
               },
               {
                   "id": "UK_SIZE",
                   "name": "UK",
                   "values": [
                       {
                           "name": "4 UK",
                           "struct": {
                               "number": 4.0,
                               "unit": "UK"
                           }
                       }
                   ]
               }
           ]
       },
       {
           "id": "467833:3",
           "attributes": [
               {
                   "id": "SIZE",
                   "name": "Size",
                   "values": [
                       {
                           "name": "7 US",
                           "struct": {
                               "number": 7.0,
                               "unit": "US"
                           }
                       }
                   ]
               },
               {
                   "id": "FOOT_LENGTH",
                   "name": "Foot length",
                   "values": [
                       {
                           "name": "24 cm",
                           "struct": {
                               "number": 24.0,
                               "unit": "cm"
                           }
                       },
                       {
                           "name": "24 cm",
                           "struct": {
                               "number": 24.0,
                               "unit": "cm"
                           }
                       }
                   ]
               },
               {
                   "id": "FOOT_LENGTH_TO",
                   "name": "Foot length to",
                   "values": [
                       {
                           "name": "25 cm",
                           "struct": {
                               "number": 25.0,
                               "unit": "cm"
                           }
                       },
                       {
                           "name": "25 cm",
                           "struct": {
                               "number": 25.0,
                               "unit": "cm"
                           }
                       }
                   ]
               },
               {
                   "id": "BR_SIZE",
                   "name": "BR",
                   "values": [
                       {
                           "name": "37 BR",
                           "struct": {
                               "number": 37.0,
                               "unit": "BR"
                           }
                       }
                   ]
               },
               {
                   "id": "MX_SIZE",
                   "name": "MX",
                   "values": [
                       {
                           "name": "7 MX",
                           "struct": {
                               "number": 7.0,
                               "unit": "MX"
                           }
                       }
                   ]
               },
               {
                   "id": "F_US_SIZE",
                   "name": "US-F",
                   "values": [
                       {
                           "name": "7 US",
                           "struct": {
                               "number": 7.0,
                               "unit": "US"
                           }
                       }
                   ]
               },
               {
                   "id": "EU_SIZE",
                   "name": "EU",
                   "values": [
                       {
                           "name": "38 EU",
                           "struct": {
                               "number": 38.0,
                               "unit": "EU"
                           }
                       }
                   ]
               },
               {
                   "id": "UK_SIZE",
                   "name": "UK",
                   "values": [
                       {
                           "name": "5 UK",
                           "struct": {
                               "number": 5.0,
                               "unit": "UK"
                           }
                       }
                   ]
               }
           ]
       }
   ],
   "template_id": "SITE:CBT-DOMAIN:SNEAKERS-GENDER:Woman"
}

Update Size chart

This endpoint allows updating the size chart to add or edit rows, measurements, etc. To modify a guide, define only the fields that must be modified. In the case of attributes and rows, the objects sent in the list, if they previously existed in the directory, are modified and if they do not exist, they are created.

Request:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" https://api.mercadolibre.com/catalog/charts/$CHART_ID

Example:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' https://api.mercadolibre.com/catalog/charts/467833 -d
'{
  "rows": [
      {
          "id": "467833:3",
          "sites": [
              "MLM",
              "MLB"
          ],
          "attributes": [
              {
                  "id": "FOOT_LENGTH",
                  "values": [
                      {
                          "name": "24.5 cm",
                          "struct": {
                              "number": 24.5,
                              "unit": "cm"
                          }
                      }
                  ]
              },
              {
                  "id": "FOOT_LENGTH_TO",
                  "values": [
                      {
                          "name": "25.5 cm",
                          "struct": {
                              "number": 25.5,
                              "unit": "cm"
                          }
                      }
                  ]
              },
   {
                   "id": "BR_SIZE",
                   "name": "BR",
                   "values": [
                       {
                           "name": "37.5 BR",
                           "struct": {
                               "number": 37.5,
                               "unit": "BR"
                           }
                       }
                   ]
               },
               {
                   "id": "MX_SIZE",
                   "name": "MX",
                   "values": [
                       {
                           "name": "7.5 MX",
                           "struct": {
                               "number": 7.5,
                               "unit": "MX"
                           }
                       }
                   ]
               },
               {
                   "id": "EU_SIZE",
                   "name": "EU",
                   "values": [
                       {
                           "name": "39 EU",
                           "struct": {
                               "number": 39.0,
                               "unit": "EU"
                           }
                       }
                   ]
               },
              {
                   "id": "UK_SIZE",
                   "name": "UK",
                   "values": [
                       {
                           "name": "5.5 UK",
                           "struct": {
                               "number": 5.5,
                               "unit": "UK"
                           }
                       }
                   ]
               }
          ]
      }
  ]
}' 

Response: 200 OK

{
   "id": "467833",
   "names": {
       "CBT": "Woman Sneakers"
   },
   "domain_id": "SNEAKERS",
   "site_id": "CBT",
   "type": "SPECIFIC",
   "seller_id": 1173213765,
   "main_attribute_id": "F_US_SIZE",
   "secondary_attribute_id": "EU_SIZE",
   "attributes": [
       {
           "id": "GENDER",
           "name": "Gender",
           "values": [
               {
                   "id": "339665",
                   "name": "Woman"
               }
           ]
       }
   ],
   "rows": [
       {
           "id": "467833:1",
           "attributes": [
               {
                   "id": "SIZE",
                   "name": "Size",
                   "values": [
                       {
                           "name": "5 US",
                           "struct": {
                               "number": 5.0,
                               "unit": "US"
                           }
                       }
                   ]
               },
               {
                   "id": "FOOT_LENGTH",
                   "name": "Foot length",
                   "values": [
                       {
                           "name": "21.5 cm",
                           "struct": {
                               "number": 21.5,
                               "unit": "cm"
                           }
                       },
                       {
                           "name": "21.5 cm",
                           "struct": {
                               "number": 21.5,
                               "unit": "cm"
                           }
                       }
                   ]
               },
               {
                   "id": "FOOT_LENGTH_TO",
                   "name": "Foot length to",
                   "values": [
                       {
                           "name": "22.5 cm",
                           "struct": {
                               "number": 22.5,
                               "unit": "cm"
                           }
                       },
                       {
                           "name": "22.5 cm",
                           "struct": {
                               "number": 22.5,
                               "unit": "cm"
                           }
                       }
                   ]
               },
               {
                   "id": "BR_SIZE",
                   "name": "BR",
                   "values": [
                       {
                           "name": "34 BR",
                           "struct": {
                               "number": 34.0,
                               "unit": "BR"
                           }
                       }
                   ]
               },
               {
                   "id": "MX_SIZE",
                   "name": "MX",
                   "values": [
                       {
                           "name": "5 MX",
                           "struct": {
                               "number": 5.0,
                               "unit": "MX"
                           }
                       }
                   ]
               },
               {
                   "id": "F_US_SIZE",
                   "name": "US-F",
                   "values": [
                       {
                           "name": "5 US",
                           "struct": {
                               "number": 5.0,
                               "unit": "US"
                           }
                       }
                   ]
               },
               {
                   "id": "EU_SIZE",
                   "name": "EU",
                   "values": [
                       {
                           "name": "36 EU",
                           "struct": {
                               "number": 36.0,
                               "unit": "EU"
                           }
                       }
                   ]
               },
               {
                   "id": "UK_SIZE",
                   "name": "UK",
                   "values": [
                       {
                           "name": "3 UK",
                           "struct": {
                               "number": 3.0,
                               "unit": "UK"
                           }
                       }
                   ]
               }
           ]
       },
       {
           "id": "467833:2",
           "attributes": [
               {
                   "id": "SIZE",
                   "name": "Size",
                   "values": [
                       {
                           "name": "6 US",
                           "struct": {
                               "number": 6.0,
                               "unit": "US"
                           }
                       }
                   ]
               },
               {
                   "id": "FOOT_LENGTH",
                   "name": "Foot length",
                   "values": [
                       {
                           "name": "23 cm",
                           "struct": {
                               "number": 23.0,
                               "unit": "cm"
                           }
                       },
                       {
                           "name": "23 cm",
                           "struct": {
                               "number": 23.0,
                               "unit": "cm"
                           }
                       }
                   ]
               },
               {
                   "id": "BR_SIZE",
                   "name": "BR",
                   "values": [
                       {
                           "name": "36 BR",
                           "struct": {
                               "number": 36.0,
                               "unit": "BR"
                           }
                       }
                   ]
               },
               {
                   "id": "MX_SIZE",
                   "name": "MX",
                   "values": [
                       {
                           "name": "6 MX",
                           "struct": {
                               "number": 6.0,
                               "unit": "MX"
                           }
                       }
                   ]
               },
               {
                   "id": "F_US_SIZE",
                   "name": "US-F",
                   "values": [
                       {
                           "name": "6 US",
                           "struct": {
                               "number": 6.0,
                               "unit": "US"
                           }
                       }
                   ]
               },
               {
                   "id": "EU_SIZE",
                   "name": "EU",
                   "values": [
                       {
                           "name": "37 EU",
                           "struct": {
                               "number": 37.0,
                               "unit": "EU"
                           }
                       }
                   ]
               },
               {
                   "id": "UK_SIZE",
                   "name": "UK",
                   "values": [
                       {
                           "name": "4 UK",
                           "struct": {
                               "number": 4.0,
                               "unit": "UK"
                           }
                       }
                   ]
               }
           ]
       },
       {
           "id": "467833:3",
           "attributes": [
               {
                   "id": "SIZE",
                   "name": "Size",
                   "values": [
                       {
                           "name": "7 US",
                           "struct": {
                               "number": 7.0,
                               "unit": "US"
                           }
                       }
                   ]
               },
               {
                   "id": "FOOT_LENGTH",
                   "name": "Foot length",
                   "values": [
                       {
                           "name": "24.5 cm",
                           "struct": {
                               "number": 24.5,
                               "unit": "cm"
                           }
                       }
                   ]
               },
               {
                   "id": "FOOT_LENGTH_TO",
                   "name": "Foot length to",
                   "values": [
                       {
                           "name": "25.5 cm",
                           "struct": {
                               "number": 25.5,
                               "unit": "cm"
                           }
                       }
                   ]
               },
               {
                   "id": "BR_SIZE",
                   "name": "BR",
                   "values": [
                       {
                           "name": "37.5 BR",
                           "struct": {
                               "number": 37.5,
                               "unit": "BR"
                           }
                       }
                   ]
               },
               {
                   "id": "MX_SIZE",
                   "name": "MX",
                   "values": [
                       {
                           "name": "7.5 MX",
                           "struct": {
                               "number": 7.5,
                               "unit": "MX"
                           }
                       }
                   ]
               },
               {
                   "id": "F_US_SIZE",
                   "name": "US-F",
                   "values": [
                       {
                           "name": "7 US",
                           "struct": {
                               "number": 7.0,
                               "unit": "US"
                           }
                       }
                   ]
               },
               {
                   "id": "EU_SIZE",
                   "name": "EU",
                   "values": [
                       {
                           "name": "39 EU",
                           "struct": {
                               "number": 39.0,
                               "unit": "EU"
                           }
                       }
                   ]
               },
               {
                   "id": "UK_SIZE",
                   "name": "UK",
                   "values": [
                       {
                           "name": "5.5 UK",
                           "struct": {
                               "number": 5.5,
                               "unit": "UK"
                           }
                       }
                   ]
               }
           ]
       }
   ]
}

Add row

This endpoint allows you to add rows to an existing chart.


Request:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" https://api.mercadolibre.com/catalog/charts/$CHART_ID/rows

Example:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' https://api.mercadolibre.com/catalog/charts/467833/rows -d 
'{
    "attributes": [
        {
            "id": "FOOT_LENGTH",
            "values": [
                {
                    "name": "25.5 cm",
                    "struct": {
                        "number": 21.5,
                        "unit": "cm"
                    }
                }
            ]
        },
        {
            "id": "FOOT_LENGTH_TO",
            "values": [
                {
                    "name": "26.5 cm",
                    "struct": {
                        "number": 22.5,
                        "unit": "cm"
                    }
                }
            ]
        },
        {
            "id": "BR_SIZE",
            "values": [
                {
                    "name": "38 BR",
                    "struct": {
                        "number": 38.0,
                        "unit": "BR"
                    }
                }
            ]
        },
        {
            "id": "MX_SIZE",
            "values": [
                {
                    "name": "8 MX",
                    "struct": {
                        "number": 8.0,
                        "unit": "MX"
                    }
                }
            ]
        },
        {
            "id": "F_US_SIZE",
            "values": [
                {
                    "name": "8 US",
                    "struct": {
                        "number": 8.0,
                        "unit": "US"
                    }
                }
            ]
        },
        {
            "id": "EU_SIZE",
            "values": [
                {
                    "name": "40 EU",
                    "struct": {
                        "number": 40.0,
                        "unit": "EU"
                    }
                }
            ]
        },
        {
            "id": "UK_SIZE",
            "values": [
                {
                    "name": "6 UK",
                    "struct": {
                        "number": 6.0,
                        "unit": "UK"
                    }
                }
            ]
        }
    ]
}'

Response: 201 Created

{
   "id": "467833",
   "names": {
       "CBT": "Woman Sneakers"
   },
   "domain_id": "SNEAKERS",
   "site_id": "CBT",
   "type": "SPECIFIC",
   "seller_id": 1173213765,
   "main_attribute_id": "F_US_SIZE",
   "secondary_attribute_id": "EU_SIZE",
   "attributes": [
       {
           "id": "GENDER",
           "name": "Gender",
           "values": [
               {
                   "id": "339665",
                   "name": "Woman"
               }
           ]
       }
   ],
   "rows": [
       {
           "id": "467833:1",
           "attributes": [
               {
                   "id": "SIZE",
                   "name": "Size",
                   "values": [
                       {
                           "name": "5 US",
                           "struct": {
                               "number": 5.0,
                               "unit": "US"
                           }
                       }
                   ]
               },
               {
                   "id": "FOOT_LENGTH",
                   "name": "Foot length",
                   "values": [
                       {
                           "name": "21.5 cm",
                           "struct": {
                               "number": 21.5,
                               "unit": "cm"
                           }
                       },
                       {
                           "name": "21.5 cm",
                           "struct": {
                               "number": 21.5,
                               "unit": "cm"
                           }
                       }
                   ]
               },
               {
                   "id": "FOOT_LENGTH_TO",
                   "name": "Foot length to",
                   "values": [
                       {
                           "name": "22.5 cm",
                           "struct": {
                               "number": 22.5,
                               "unit": "cm"
                           }
                       },
                       {
                           "name": "22.5 cm",
                           "struct": {
                               "number": 22.5,
                               "unit": "cm"
                           }
                       }
                   ]
               },
               {
                   "id": "BR_SIZE",
                   "name": "BR",
                   "values": [
                       {
                           "name": "34 BR",
                           "struct": {
                               "number": 34.0,
                               "unit": "BR"
                           }
                       }
                   ]
               },
               {
                   "id": "MX_SIZE",
                   "name": "MX",
                   "values": [
                       {
                           "name": "5 MX",
                           "struct": {
                               "number": 5.0,
                               "unit": "MX"
                           }
                       }
                   ]
               },
               {
                   "id": "F_US_SIZE",
                   "name": "US-F",
                   "values": [
                       {
                           "name": "5 US",
                           "struct": {
                               "number": 5.0,
                               "unit": "US"
                           }
                       }
                   ]
               },
               {
                   "id": "EU_SIZE",
                   "name": "EU",
                   "values": [
                       {
                           "name": "36 EU",
                           "struct": {
                               "number": 36.0,
                               "unit": "EU"
                           }
                       }
                   ]
               },
               {
                   "id": "UK_SIZE",
                   "name": "UK",
                   "values": [
                       {
                           "name": "3 UK",
                           "struct": {
                               "number": 3.0,
                               "unit": "UK"
                           }
                       }
                   ]
               }
           ]
       },
       {
           "id": "467833:2",
           "attributes": [
               {
                   "id": "SIZE",
                   "name": "Size",
                   "values": [
                       {
                           "name": "6 US",
                           "struct": {
                               "number": 6.0,
                               "unit": "US"
                           }
                       }
                   ]
               },
               {
                   "id": "FOOT_LENGTH",
                   "name": "Foot length",
                   "values": [
                       {
                           "name": "23 cm",
                           "struct": {
                               "number": 23.0,
                               "unit": "cm"
                           }
                       },
                       {
                           "name": "23 cm",
                           "struct": {
                               "number": 23.0,
                               "unit": "cm"
                           }
                       }
                   ]
               },
               {
                   "id": "BR_SIZE",
                   "name": "BR",
                   "values": [
                       {
                           "name": "36 BR",
                           "struct": {
                               "number": 36.0,
                               "unit": "BR"
                           }
                       }
                   ]
               },
               {
                   "id": "MX_SIZE",
                   "name": "MX",
                   "values": [
                       {
                           "name": "6 MX",
                           "struct": {
                               "number": 6.0,
                               "unit": "MX"
                           }
                       }
                   ]
               },
               {
                   "id": "F_US_SIZE",
                   "name": "US-F",
                   "values": [
                       {
                           "name": "6 US",
                           "struct": {
                               "number": 6.0,
                               "unit": "US"
                           }
                       }
                   ]
               },
               {
                   "id": "EU_SIZE",
                   "name": "EU",
                   "values": [
                       {
                           "name": "37 EU",
                           "struct": {
                               "number": 37.0,
                               "unit": "EU"
                           }
                       }
                   ]
               },
               {
                   "id": "UK_SIZE",
                   "name": "UK",
                   "values": [
                       {
                           "name": "4 UK",
                           "struct": {
                               "number": 4.0,
                               "unit": "UK"
                           }
                       }
                   ]
               }
           ]
       },
       {
           "id": "467833:3",
           "attributes": [
               {
                   "id": "SIZE",
                   "name": "Size",
                   "values": [
                       {
                           "name": "7 US",
                           "struct": {
                               "number": 7.0,
                               "unit": "US"
                           }
                       }
                   ]
               },
               {
                   "id": "FOOT_LENGTH",
                   "name": "Foot length",
                   "values": [
                       {
                           "name": "24.5 cm",
                           "struct": {
                               "number": 24.5,
                               "unit": "cm"
                           }
                       }
                   ]
               },
               {
                   "id": "FOOT_LENGTH_TO",
                   "name": "Foot length to",
                   "values": [
                       {
                           "name": "25.5 cm",
                           "struct": {
                               "number": 25.5,
                               "unit": "cm"
                           }
                       }
                   ]
               },
               {
                   "id": "BR_SIZE",
                   "name": "BR",
                   "values": [
                       {
                           "name": "37.5 BR",
                           "struct": {
                               "number": 37.5,
                               "unit": "BR"
                           }
                       }
                   ]
               },
               {
                   "id": "MX_SIZE",
                   "name": "MX",
                   "values": [
                       {
                           "name": "7.5 MX",
                           "struct": {
                               "number": 7.5,
                               "unit": "MX"
                           }
                       }
                   ]
               },
               {
                   "id": "F_US_SIZE",
                   "name": "US-F",
                   "values": [
                       {
                           "name": "7 US",
                           "struct": {
                               "number": 7.0,
                               "unit": "US"
                           }
                       }
                   ]
               },
               {
                   "id": "EU_SIZE",
                   "name": "EU",
                   "values": [
                       {
                           "name": "39 EU",
                           "struct": {
                               "number": 39.0,
                               "unit": "EU"
                           }
                       }
                   ]
               },
               {
                   "id": "UK_SIZE",
                   "name": "UK",
                   "values": [
                       {
                           "name": "5.5 UK",
                           "struct": {
                               "number": 5.5,
                               "unit": "UK"
                           }
                       }
                   ]
               }
           ]
       },
       {
           "id": "467833:4",
           "attributes": [
               {
                   "id": "SIZE",
                   "name": "Size",
                   "values": [
                       {
                           "name": "8 US",
                           "struct": {
                               "number": 8.0,
                               "unit": "US"
                           }
                       }
                   ]
               },
               {
                   "id": "FOOT_LENGTH",
                   "name": "Foot length",
                   "values": [
                       {
                           "name": "25.5 cm",
                           "struct": {
                               "number": 25.5,
                               "unit": "cm"
                           }
                       }
                   ]
               },
               {
                   "id": "FOOT_LENGTH_TO",
                   "name": "Foot length to",
                   "values": [
                       {
                           "name": "26.5 cm",
                           "struct": {
                               "number": 26.5,
                               "unit": "cm"
                           }
                       }
                   ]
               },
               {
                   "id": "BR_SIZE",
                   "name": "BR",
                   "values": [
                       {
                           "name": "38 BR",
                           "struct": {
                               "number": 38.0,
                               "unit": "BR"
                           }
                       }
                   ]
               },
               {
                   "id": "MX_SIZE",
                   "name": "MX",
                   "values": [
                       {
                           "name": "8 MX",
                           "struct": {
                               "number": 8.0,
                               "unit": "MX"
                           }
                       }
                   ]
               },
               {
                   "id": "F_US_SIZE",
                   "name": "US-F",
                   "values": [
                       {
                           "name": "8 US",
                           "struct": {
                               "number": 8.0,
                               "unit": "US"
                           }
                       }
                   ]
               },
               {
                   "id": "EU_SIZE",
                   "name": "EU",
                   "values": [
                       {
                           "name": "40 EU",
                           "struct": {
                               "number": 40.0,
                               "unit": "EU"
                           }
                       }
                   ]
               },
               {
                   "id": "UK_SIZE",
                   "name": "UK",
                   "values": [
                       {
                           "name": "6 UK",
                           "struct": {
                               "number": 6.0,
                               "unit": "UK"
                           }
                       }
                   ]
               }
           ]
       }
   ]
}

Edit row information

This endpoint allows you to edit the information of an existing row in the size guide. Bear in mind that when modifying, you can not edit the main item (main_attribute) of each queue (row) and neither can you delete queues.


Request:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" https://api.mercadolibre.com/catalog/charts/$CHART_ID/rows/$ROW_ID

Example:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' https://api.mercadolibre.com/catalog/charts/467833/rows/467833:3 -d 
'{
    "attributes": [
        {
            "id": "BR_SIZE",
            "name": "BR",
            "values": [
                {
                    "name": "37 BR",
                    "struct": {
                        "number": 37,
                        "unit": "BR"
                    }
                }
            ]
        }
    ]
}'  

Response: 200 Ok

{
    "id": "467833",
    "names": {
        "CBT": "Woman Sneakers"
    },
    "domain_id": "SNEAKERS",
    "site_id": "CBT",
    "type": "SPECIFIC",
    "seller_id": 1173213765,
    "main_attribute_id": "F_US_SIZE",
    "secondary_attribute_id": "EU_SIZE",
    "attributes": [
        {
            "id": "GENDER",
            "name": "Gender",
            "values": [
                {
                    "id": "339665",
                    "name": "Woman"
                }
            ]
        }
    ],
    "rows": [
        {
            "id": "467833:1",
            "attributes": [
                {
                    "id": "SIZE",
                    "name": "Size",
                    "values": [
                        {
                            "name": "5 US",
                            "struct": {
                                "number": 5.0,
                                "unit": "US"
                            }
                        }
                    ]
                },
                {
                    "id": "FOOT_LENGTH",
                    "name": "Foot length",
                    "values": [
                        {
                            "name": "21.5 cm",
                            "struct": {
                                "number": 21.5,
                                "unit": "cm"
                            }
                        },
                        {
                            "name": "21.5 cm",
                            "struct": {
                                "number": 21.5,
                                "unit": "cm"
                            }
                        }
                    ]
                },
                {
                    "id": "FOOT_LENGTH_TO",
                    "name": "Foot length to",
                    "values": [
                        {
                            "name": "22.5 cm",
                            "struct": {
                                "number": 22.5,
                                "unit": "cm"
                            }
                        },
                        {
                            "name": "22.5 cm",
                            "struct": {
                                "number": 22.5,
                                "unit": "cm"
                            }
                        }
                    ]
                },
                {
                    "id": "BR_SIZE",
                    "name": "BR",
                    "values": [
                        {
                            "name": "34 BR",
                            "struct": {
                                "number": 34.0,
                                "unit": "BR"
                            }
                        }
                    ]
                },
                {
                    "id": "MX_SIZE",
                    "name": "MX",
                    "values": [
                        {
                            "name": "5 MX",
                            "struct": {
                                "number": 5.0,
                                "unit": "MX"
                            }
                        }
                    ]
                },
                {
                    "id": "F_US_SIZE",
                    "name": "US-F",
                    "values": [
                        {
                            "name": "5 US",
                            "struct": {
                                "number": 5.0,
                                "unit": "US"
                            }
                        }
                    ]
                },
                {
                    "id": "EU_SIZE",
                    "name": "EU",
                    "values": [
                        {
                            "name": "36 EU",
                            "struct": {
                                "number": 36.0,
                                "unit": "EU"
                            }
                        }
                    ]
                },
                {
                    "id": "UK_SIZE",
                    "name": "UK",
                    "values": [
                        {
                            "name": "3 UK",
                            "struct": {
                                "number": 3.0,
                                "unit": "UK"
                            }
                        }
                    ]
                }
            ]
        },
        {
            "id": "467833:2",
            "attributes": [
                {
                    "id": "SIZE",
                    "name": "Size",
                    "values": [
                        {
                            "name": "6 US",
                            "struct": {
                                "number": 6.0,
                                "unit": "US"
                            }
                        }
                    ]
                },
                {
                    "id": "FOOT_LENGTH",
                    "name": "Foot length",
                    "values": [
                        {
                            "name": "23 cm",
                            "struct": {
                                "number": 23.0,
                                "unit": "cm"
                            }
                        },
                        {
                            "name": "23 cm",
                            "struct": {
                                "number": 23.0,
                                "unit": "cm"
                            }
                        }
                    ]
                },
                {
                    "id": "BR_SIZE",
                    "name": "BR",
                    "values": [
                        {
                            "name": "36 BR",
                            "struct": {
                                "number": 36.0,
                                "unit": "BR"
                            }
                        }
                    ]
                },
                {
                    "id": "MX_SIZE",
                    "name": "MX",
                    "values": [
                        {
                            "name": "6 MX",
                            "struct": {
                                "number": 6.0,
                                "unit": "MX"
                            }
                        }
                    ]
                },
                {
                    "id": "F_US_SIZE",
                    "name": "US-F",
                    "values": [
                        {
                            "name": "6 US",
                            "struct": {
                                "number": 6.0,
                                "unit": "US"
                            }
                        }
                    ]
                },
                {
                    "id": "EU_SIZE",
                    "name": "EU",
                    "values": [
                        {
                            "name": "37 EU",
                            "struct": {
                                "number": 37.0,
                                "unit": "EU"
                            }
                        }
                    ]
                },
                {
                    "id": "UK_SIZE",
                    "name": "UK",
                    "values": [
                        {
                            "name": "4 UK",
                            "struct": {
                                "number": 4.0,
                                "unit": "UK"
                            }
                        }
                    ]
                }
            ]
        },
        {
            "id": "467833:3",
            "attributes": [
                {
                    "id": "SIZE",
                    "name": "Size",
                    "values": [
                        {
                            "name": "7 US",
                            "struct": {
                                "number": 7.0,
                                "unit": "US"
                            }
                        }
                    ]
                },
                {
                    "id": "FOOT_LENGTH",
                    "name": "Foot length",
                    "values": [
                        {
                            "name": "24.5 cm",
                            "struct": {
                                "number": 24.5,
                                "unit": "cm"
                            }
                        }
                    ]
                },
                {
                    "id": "FOOT_LENGTH_TO",
                    "name": "Foot length to",
                    "values": [
                        {
                            "name": "25.5 cm",
                            "struct": {
                                "number": 25.5,
                                "unit": "cm"
                            }
                        }
                    ]
                },
                {
                    "id": "BR_SIZE",
                    "name": "BR",
                    "values": [
                        {
                            "name": "37 BR",
                            "struct": {
                                "number": 37.0,
                                "unit": "BR"
                            }
                        }
                    ]
                },
                {
                    "id": "MX_SIZE",
                    "name": "MX",
                    "values": [
                        {
                            "name": "7.5 MX",
                            "struct": {
                                "number": 7.5,
                                "unit": "MX"
                            }
                        }
                    ]
                },
                {
                    "id": "F_US_SIZE",
                    "name": "US-F",
                    "values": [
                        {
                            "name": "7 US",
                            "struct": {
                                "number": 7.0,
                                "unit": "US"
                            }
                        }
                    ]
                },
                {
                    "id": "EU_SIZE",
                    "name": "EU",
                    "values": [
                        {
                            "name": "39 EU",
                            "struct": {
                                "number": 39.0,
                                "unit": "EU"
                            }
                        }
                    ]
                },
                {
                    "id": "UK_SIZE",
                    "name": "UK",
                    "values": [
                        {
                            "name": "5.5 UK",
                            "struct": {
                                "number": 5.5,
                                "unit": "UK"
                            }
                        }
                    ]
                }
            ]
        },
        {
            "id": "467833:4",
            "attributes": [
                {
                    "id": "SIZE",
                    "name": "Size",
                    "values": [
                        {
                            "name": "8 US",
                            "struct": {
                                "number": 8.0,
                                "unit": "US"
                            }
                        }
                    ]
                },
                {
                    "id": "FOOT_LENGTH",
                    "name": "Foot length",
                    "values": [
                        {
                            "name": "25.5 cm",
                            "struct": {
                                "number": 25.5,
                                "unit": "cm"
                            }
                        }
                    ]
                },
                {
                    "id": "FOOT_LENGTH_TO",
                    "name": "Foot length to",
                    "values": [
                        {
                            "name": "26.5 cm",
                            "struct": {
                                "number": 26.5,
                                "unit": "cm"
                            }
                        }
                    ]
                },
                {
                    "id": "BR_SIZE",
                    "name": "BR",
                    "values": [
                        {
                            "name": "38 BR",
                            "struct": {
                                "number": 38.0,
                                "unit": "BR"
                            }
                        }
                    ]
                },
                {
                    "id": "MX_SIZE",
                    "name": "MX",
                    "values": [
                        {
                            "name": "8 MX",
                            "struct": {
                                "number": 8.0,
                                "unit": "MX"
                            }
                        }
                    ]
                },
                {
                    "id": "F_US_SIZE",
                    "name": "US-F",
                    "values": [
                        {
                            "name": "8 US",
                            "struct": {
                                "number": 8.0,
                                "unit": "US"
                            }
                        }
                    ]
                },
                {
                    "id": "EU_SIZE",
                    "name": "EU",
                    "values": [
                        {
                            "name": "40 EU",
                            "struct": {
                                "number": 40.0,
                                "unit": "EU"
                            }
                        }
                    ]
                },
                {
                    "id": "UK_SIZE",
                    "name": "UK",
                    "values": [
                        {
                            "name": "6 UK",
                            "struct": {
                                "number": 6.0,
                                "unit": "UK"
                            }
                        }
                    ]
                }
            ]
        }
    ]
}

Associate size chart

1. Create Item with size chart

To associate a size chart to listings within the required domains, you will have to execute a POST on the items, sending the new attributes of type SIZE_GRID_ID, the size chart which we want to associate the item or variation and SIZE_GRID_ROW_ID with reference to the row in the size chart.


Request:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" https://api.mercadolibre.com/items -d

Example:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' https://api.mercadolibre.com/items -d 
'{
   "site_id": "CBT",
   "title": "CREATE ITEM WITH - GDT SNEAKER WOMAN",
   "category_id": "CBT3724",
   "official_store_id": null,
   "price": 12,
   "currency_id": "USD",
   "available_quantity": 7,
   "sale_terms": [
       {
           "id": "WARRANTY_TYPE",
           "name": "Warranty type",
           "value_id": "6150835",
           "value_name": "No warranty",
           "value_struct": null,
           "values": [
               {
                   "id": "6150835",
                   "name": "No warranty",
                   "struct": null
               }
           ],
           "value_type": "list"
       }
   ],
   "buying_mode": "buy_it_now",
   "listing_type_id": "gold_pro",
   "start_time": "2022-10-17T20:18:52.000Z",
   "condition": "new",
    "pictures": [
       {
           "id": "644516-CBT51699767208_092022",
           "url": "http://http2.mlstatic.com/D_644516-CBT51699767208_092022-O.jpg",
           "secure_url": "https://http2.mlstatic.com/D_644516-CBT51699767208_092022-O.jpg",
           "size": "500x247",
           "max_size": "1205x597",
           "quality": ""
       },
       {
           "id": "862503-CBT51700450573_092022",
           "url": "http://http2.mlstatic.com/D_862503-CBT51700450573_092022-O.jpg",
           "secure_url": "https://http2.mlstatic.com/D_862503-CBT51700450573_092022-O.jpg",
           "size": "500x247",
           "max_size": "1214x600",
           "quality": ""
       }
   ],
   "video_id": null,
   "accepts_mercadopago": true,
   "non_mercado_pago_payment_methods": [],
   "shipping": {
       "mode": "not_specified",
       "methods": [],
       "tags": [],
       "dimensions": null,
       "local_pick_up": false,
       "free_shipping": false,
       "logistic_type": "not_specified",
       "store_pick_up": false
   },
   "seller_address": {
       "address_line": "No.1003 shennandadao road, futian District",
       "zip_code": "518033",
       "city": {
           "id": "Q04tR0RTaGVuemhlbg",
           "name": "Shenzhen"
       },
       "state": {
           "id": "CN-GD",
           "name": "Guangdong"
       },
       "country": {
           "id": "CN",
           "name": "China"
       }
   },
   "location": {},
   "coverage_areas": [],
   "attributes": [
        {
           "id" :"SIZE_GRID_ID",
           "value_name": "467833"
       },
       {
           "id": "AGE_GROUP",
           "name": "Age group",
           "value_id": "6725189",
           "value_name": "Adults",
           "value_struct": null,
           "values": [
               {
                   "id": "6725189",
                   "name": "Adults",
                   "struct": null,
                   "source": 2579503448603610
               }
           ],
           "attribute_group_id": "OTHERS",
           "attribute_group_name": "Others",
           "source": 2579503448603610,
           "value_type": "list"
       },
       {
           "id": "BRAND",
           "name": "Brand",
           "value_id": "null",
           "value_name": "Generic",
           "value_struct": null,
           "values": [
               {
                   "id": "null",
                   "name": "Generic",
                   "struct": null,
                   "source": 4954751883138633
               }
           ],
           "attribute_group_id": "OTHERS",
           "attribute_group_name": "Others",
           "source": 4954751883138633,
           "value_type": "string"
       },
       {
           "id": "FOOTWEAR_TYPE",
           "name": "Footwear type",
           "value_id": "517583",
           "value_name": "Sneaker",
           "value_struct": null,
           "values": [
               {
                   "id": "517583",
                   "name": "Sneaker",
                   "struct": null,
                   "source": 4954751883138633
               }
           ],
           "attribute_group_id": "OTHERS",
           "attribute_group_name": "Others",
           "source": 4954751883138633,
           "value_type": "list"
       },
       {
           "id": "GENDER",
           "name": "Gender",
           "value_id": "339665",
           "value_name": "Woman",
           "value_struct": null,
           "values": [
               {
                   "id": "339665",
                   "name": "Woman",
                   "struct": null,
                   "source": 4954751883138633
               }
           ],
           "attribute_group_id": "OTHERS",
           "attribute_group_name": "Others",
           "source": 4954751883138633,
           "value_type": "list"
       },
       {
           "id": "ITEM_CONDITION",
           "name": "Item condition",
           "value_id": "2230284",
           "value_name": "New",
           "value_struct": null,
           "values": [
               {
                   "id": "2230284",
                   "name": "New",
                   "struct": null,
                   "source": 4954751883138633
               }
           ],
           "attribute_group_id": "OTHERS",
           "attribute_group_name": "Others",
           "source": 4954751883138633,
           "value_type": "list"
       },
       {
           "id": "MODEL",
           "name": "Model",
           "value_id": null,
           "value_name": "generic",
           "value_struct": null,
           "values": [
               {
                   "id": null,
                   "name": "generic",
                   "struct": null,
                   "source": 4954751883138633
               }
           ],
           "attribute_group_id": "OTHERS",
           "attribute_group_name": "Others",
           "source": 4954751883138633,
           "value_type": "string"
       },
       {
           "id": "STYLE",
           "name": "Style",
           "value_id": "6694773",
           "value_name": "Urban",
           "value_struct": null,
           "values": [
               {
                   "id": "6694773",
                   "name": "Urban",
                   "struct": null,
                   "source": 4954751883138633
               }
           ],
           "attribute_group_id": "OTHERS",
           "attribute_group_name": "Others",
           "source": 4954751883138633,
           "value_type": "list"
       }
   ],
   "variations": [
       {
           "id": 175507138874,
           "price": 12,
           "attribute_combinations": [
               {
                   "id": "COLOR",
                   "name": "Color",
                   "value_id": "52049",
                   "value_name": "Black",
                   "value_struct": null,
                   "values": [
                       {
                           "id": "52049",
                           "name": "Black",
                           "struct": null,
                           "source": 4954751883138633
                       }
                   ],
                   "source": 4954751883138633,
                   "value_type": "string"
               },
               {
                   "id": "SIZE",
                   "name": "Size",
                   "value_id": "null",
                   "value_name": "5 US-F",
                   "value_struct": null,
                   "values": [
                       {
                           "id": "nul",
                           "name": "5 US-F",
                           "struct": null,
                           "source": 3376461333454861
                       }
                   ],
                   "source": 3376461333454861,
                   "value_type": "string"
               }
           ],
           "available_quantity": 5,
           "sale_terms": [],
           "picture_ids": [
               "644516-CBT51699767208_092022"
           ],
           "seller_custom_field": null,
           "catalog_product_id": null,
           "attributes": [
               {
                   "id" :"SIZE_GRID_ROW_ID",
                   "value_name": "467833:1"
               },
               {
                   "id": "MAIN_COLOR",
                   "name": "Main color",
                   "value_id": "2450295",
                   "value_name": "Black",
                   "value_struct": null,
                   "values": [
                       {
                           "id": "2450295",
                           "name": "Black",
                           "struct": null,
                           "source": 4954751883138633
                       }
                   ],
                   "source": 4954751883138633,
                   "value_type": "list"
               },
               {
                   "id": "PACKAGE_HEIGHT",
                   "name": "Package height",
                   "value_id": null,
                   "value_name": "30 cm",
                   "value_struct": {
                       "number": 30,
                       "unit": "cm"
                   },
                   "values": [
                       {
                           "id": null,
                           "name": "30 cm",
                           "struct": {
                               "number": 30,
                               "unit": "cm"
                           },
                           "source": 4954751883138633
                       }
                   ],
                   "source": 4954751883138633,
                   "value_type": "number_unit"
               },
               {
                   "id": "PACKAGE_LENGTH",
                   "name": "Package length",
                   "value_id": null,
                   "value_name": "30 cm",
                   "value_struct": {
                       "number": 30,
                       "unit": "cm"
                   },
                   "values": [
                       {
                           "id": null,
                           "name": "30 cm",
                           "struct": {
                               "number": 30,
                               "unit": "cm"
                           },
                           "source": 4954751883138633
                       }
                   ],
                   "source": 4954751883138633,
                   "value_type": "number_unit"
               },
               {
                   "id": "PACKAGE_WEIGHT",
                   "name": "Package weight",
                   "value_id": null,
                   "value_name": "1 kg",
                   "value_struct": {
                       "number": 1,
                       "unit": "kg"
                   },
                   "values": [
                       {
                           "id": null,
                           "name": "1 kg",
                           "struct": {
                               "number": 1,
                               "unit": "kg"
                           },
                           "source": 4954751883138633
                       }
                   ],
                   "source": 4954751883138633,
                   "value_type": "number_unit"
               },
               {
                   "id": "PACKAGE_WIDTH",
                   "name": "Package width",
                   "value_id": null,
                   "value_name": "30 cm",
                   "value_struct": {
                       "number": 30,
                       "unit": "cm"
                   },
                   "values": [
                       {
                           "id": null,
                           "name": "30 cm",
                           "struct": {
                               "number": 30,
                               "unit": "cm"
                           },
                           "source": 4954751883138633
                       }
                   ],
                   "source": 4954751883138633,
                   "value_type": "number_unit"
               },
               {
                   "id": "GTIN",
                   "name": "Universal product code",
                   "value_id": null,
                   "value_name": "7899680328732",
                   "value_struct": null,
                   "values": [
                       {
                           "id": null,
                           "name": "7899680328732",
                           "struct": null,
                           "source": 4954751883138633
                       }
                   ],
                   "source": 4954751883138633,
                   "value_type": "string"
               }
           ],
           "inventory_id": null,
       },
       {
           "id": 175669183151,
           "price": 12,
           "attribute_combinations": [
               {
                   "id": "COLOR",
                   "name": "Color",
                   "value_id": "52028",
                   "value_name": "Blue",
                   "value_struct": null,
                   "values": [
                       {
                           "id": "52028",
                           "name": "Blue",
                           "struct": null,
                           "source": 3376461333454861
                       }
                   ],
                   "source": 3376461333454861,
                   "value_type": "string"
               },
               {
                   "id": "SIZE",
                   "name": "Size",
                   "value_id": "null",
                   "value_name": "6 US-F",
                   "value_struct": null,
                   "values": [
                       {
                           "id": "null",
                           "name": "6 US-F",
                           "struct": null,
                           "source": 3376461333454861
                       }
                   ],
                   "source": 3376461333454861,
                   "value_type": "string"
               }
           ],
           "available_quantity": 2,
           "sold_quantity": 0,
           "sale_terms": [],
           "picture_ids": [
               "862503-CBT51700450573_092022"
           ],
           "seller_custom_field": null,
           "catalog_product_id": null,
           "attributes": [
               {
                   "id" :"SIZE_GRID_ROW_ID",
                   "value_name": "467833:2"
               },
               {
                   "id": "MAIN_COLOR",
                   "name": "Main color",
                   "value_id": "2450293",
                   "value_name": "Blue",
                   "value_struct": null,
                   "values": [
                       {
                           "id": "2450293",
                           "name": "Blue",
                           "struct": null,
                           "source": 3376461333454861
                       }
                   ],
                   "source": 3376461333454861,
                   "value_type": "list"
               },
               {
                   "id": "PACKAGE_HEIGHT",
                   "name": "Package height",
                   "value_id": null,
                   "value_name": "30 cm",
                   "value_struct": {
                       "number": 30,
                       "unit": "cm"
                   },
                   "values": [
                       {
                           "id": null,
                           "name": "30 cm",
                           "struct": {
                               "number": 30,
                               "unit": "cm"
                           },
                           "source": 3376461333454861
                       }
                   ],
                   "source": 3376461333454861,
                   "value_type": "number_unit"
               },
               {
                   "id": "PACKAGE_LENGTH",
                   "name": "Package length",
                   "value_id": null,
                   "value_name": "30 cm",
                   "value_struct": {
                       "number": 30,
                       "unit": "cm"
                   },
                   "values": [
                       {
                           "id": null,
                           "name": "30 cm",
                           "struct": {
                               "number": 30,
                               "unit": "cm"
                           },
                           "source": 3376461333454861
                       }
                   ],
                   "source": 3376461333454861,
                   "value_type": "number_unit"
               },
               {
                   "id": "PACKAGE_WEIGHT",
                   "name": "Package weight",
                   "value_id": null,
                   "value_name": "1 kg",
                   "value_struct": {
                       "number": 1,
                       "unit": "kg"
                   },
                   "values": [
                       {
                           "id": null,
                           "name": "1 kg",
                           "struct": {
                               "number": 1,
                               "unit": "kg"
                           },
                           "source": 3376461333454861
                       }
                   ],
                   "source": 3376461333454861,
                   "value_type": "number_unit"
               },
               {
                   "id": "PACKAGE_WIDTH",
                   "name": "Package width",
                   "value_id": null,
                   "value_name": "30 cm",
                   "value_struct": {
                       "number": 30,
                       "unit": "cm"
                   },
                   "values": [
                       {
                           "id": null,
                           "name": "30 cm",
                           "struct": {
                               "number": 30,
                               "unit": "cm"
                           },
                           "source": 3376461333454861
                       }
                   ],
                   "source": 3376461333454861,
                   "value_type": "number_unit"
               },
               {
                   "id": "GTIN",
                   "name": "Universal product code",
                   "value_id": null,
                   "value_name": "7899680328732",
                   "value_struct": null,
                   "values": [
                       {
                           "id": null,
                           "name": "7899680328732",
                           "struct": null,
                           "source": 3376461333454861
                       }
                   ],
                   "source": 3376461333454861,
                   "value_type": "string"
               }
           ],
           "inventory_id": null,
           "item_relations": []
       }
   ],
   "status": "active",
   "tags": [
       "test_item",
       "immediate_payment"
   ],
   "warranty": "No warranty",
   "catalog_product_id": null,
   "domain_id": "CBT-SNEAKERS",
   "seller_custom_field": null,
   "automatic_relist": false,
   "catalog_listing": false,
   "channels": [
       "marketplace"
   ]
}'

Response 202:

{
   "id": "CBT1582213276",
   "site_id": "CBT",
   "title": "Create Item With - Gdt Sneaker Woman",
   "subtitle": null,
   "seller_id": 1173213765,
   "category_id": "CBT3724",
   "official_store_id": null,
   "price": 12,
   "base_price": 12,
   "original_price": null,
   "inventory_id": null,
   "currency_id": "USD",
   "initial_quantity": 7,
   "available_quantity": 7,
   "sold_quantity": 0,
   "sale_terms": [
       {
           "id": "WARRANTY_TYPE",
           "name": "Warranty type",
           "value_id": "6150835",
           "value_name": "No warranty",
           "value_struct": null,
           "values": [
               {
                   "id": "6150835",
                   "name": "No warranty",
                   "struct": null
               }
           ],
           "value_type": "list"
       }
   ],
   "buying_mode": "buy_it_now",
   "listing_type_id": "gold_pro",
   "start_time": "2023-01-03T13:40:08.951Z",
   "stop_time": "2042-12-29T04:00:00.000Z",
   "end_time": "2042-12-29T04:00:00.000Z",
   "expiration_time": "2023-03-24T13:40:09.046Z",
   "condition": "new",
   "permalink": "",
   "pictures": [
       {
           "id": "644516-CBT51699767208_092022",
           "url": "http://cbt-s1-p.mlstatic.com/644516-CBT51699767208_092022-O.jpg",
           "secure_url": "https://cbt-s1-p.mlstatic.com/644516-CBT51699767208_092022-O.jpg",
           "size": "500x247",
           "max_size": "1200x595",
           "quality": ""
       },
       {
           "id": "862503-CBT51700450573_092022",
           "url": "http://cbt-s2-p.mlstatic.com/862503-CBT51700450573_092022-O.jpg",
           "secure_url": "https://cbt-s2-p.mlstatic.com/862503-CBT51700450573_092022-O.jpg",
           "size": "500x247",
           "max_size": "1200x594",
           "quality": ""
       }
   ],
   "video_id": null,
   "descriptions": [],
   "accepts_mercadopago": true,
   "non_mercado_pago_payment_methods": [],
   "shipping": {
       "mode": "not_specified",
       "local_pick_up": false,
       "free_shipping": false,
       "methods": [],
       "dimensions": null,
       "tags": [],
       "logistic_type": "not_specified",
       "store_pick_up": false
   },
   "international_delivery_mode": "none",
   "seller_address": {
       "id": 1247380722,
       "comment": "",
       "address_line": "No.1003 shennandadao road, futian District",
       "zip_code": "518033",
       "city": {
           "id": "Q04tR0RTaGVuemhlbg",
           "name": "Shenzhen"
       },
       "state": {
           "id": "CN-GD",
           "name": "Guangdong"
       },
       "country": {
           "id": "CN",
           "name": "China"
       },
       "latitude": "",
       "longitude": "",
       "search_location": {
           "neighborhood": {
               "id": "",
               "name": ""
           },
           "city": {
               "id": "",
               "name": ""
           },
           "state": {
               "id": "",
               "name": ""
           }
       }
   },
   "seller_contact": null,
   "location": {},
   "geolocation": {
       "latitude": "",
       "longitude": ""
   },
   "coverage_areas": [],
   "attributes": [
       {
           "id": "SIZE_GRID_ID",
           "name": "Size grid ID",
           "value_id": null,
           "value_name": "467833",
           "value_struct": null,
           "values": [
               {
                   "id": null,
                   "name": "467833",
                   "struct": null
               }
           ],
           "attribute_group_id": "OTHERS",
           "attribute_group_name": "Others",
           "value_type": "grid_id"
       },
       {
           "id": "BRAND",
           "name": "Brand",
           "value_id": null,
           "value_name": "Generic",
           "value_struct": null,
           "values": [
               {
                   "id": null,
                   "name": "Generic",
                   "struct": null
               }
           ],
           "attribute_group_id": "OTHERS",
           "attribute_group_name": "Others",
           "value_type": "string"
       },
       {
           "id": "FOOTWEAR_TYPE",
           "name": "Footwear type",
           "value_id": "517583",
           "value_name": "Sneaker",
           "value_struct": null,
           "values": [
               {
                   "id": "517583",
                   "name": "Sneaker",
                   "struct": null
               }
           ],
           "attribute_group_id": "OTHERS",
           "attribute_group_name": "Others",
           "value_type": "list"
       },
       {
           "id": "GENDER",
           "name": "Gender",
           "value_id": "339665",
           "value_name": "Woman",
           "value_struct": null,
           "values": [
               {
                   "id": "339665",
                   "name": "Woman",
                   "struct": null
               }
           ],
           "attribute_group_id": "OTHERS",
           "attribute_group_name": "Others",
           "value_type": "list"
       },
       {
           "id": "ITEM_CONDITION",
           "name": "Item condition",
           "value_id": "2230284",
           "value_name": "New",
           "value_struct": null,
           "values": [
               {
                   "id": "2230284",
                   "name": "New",
                   "struct": null
               }
           ],
           "attribute_group_id": "OTHERS",
           "attribute_group_name": "Others",
           "value_type": "list"
       },
       {
           "id": "MODEL",
           "name": "Model",
           "value_id": null,
           "value_name": "generic",
           "value_struct": null,
           "values": [
               {
                   "id": null,
                   "name": "generic",
                   "struct": null
               }
           ],
           "attribute_group_id": "OTHERS",
           "attribute_group_name": "Others",
           "value_type": "string"
       },
       {
           "id": "STYLE",
           "name": "Style",
           "value_id": "6694773",
           "value_name": "Urban",
           "value_struct": null,
           "values": [
               {
                   "id": "6694773",
                   "name": "Urban",
                   "struct": null
               }
           ],
           "attribute_group_id": "OTHERS",
           "attribute_group_name": "Others",
           "value_type": "list"
       }
   ],
   "warnings": [
       {
           "department": "items",
           "cause_id": 303,
           "code": "item.attributes.ignored",
           "message": "Attribute [AGE_GROUP] ignored because it is not modifiable.",
           "references": [
               "item.attributes"
           ]
       }
   ],
   "listing_source": "",
   "variations": [
       {
           "id": 176278545394,
           "attribute_combinations": [
               {
                   "id": "COLOR",
                   "name": "Color",
                   "value_id": "52049",
                   "value_name": "Black",
                   "value_struct": null,
                   "values": [
                       {
                           "id": "52049",
                           "name": "Black",
                           "struct": null
                       }
                   ],
                   "value_type": "string"
               },
               {
                   "id": "SIZE",
                   "name": "Size",
                   "value_id": null,
                   "value_name": "5 US-F",
                   "value_struct": null,
                   "values": [
                       {
                           "id": null,
                           "name": "5 US-F",
                           "struct": null
                       }
                   ],
                   "value_type": "string"
               }
           ],
           "price": 12,
           "available_quantity": 5,
           "sold_quantity": 0,
           "sale_terms": [],
           "picture_ids": [
               "644516-CBT51699767208_092022"
           ],
           "seller_custom_field": null,
           "catalog_product_id": null,
           "attributes": [
               {
                   "id": "MAIN_COLOR",
                   "name": "Main color",
                   "value_id": "2450295",
                   "value_name": "Black",
                   "value_struct": null,
                   "values": [
                       {
                           "id": "2450295",
                           "name": "Black",
                           "struct": null
                       }
                   ],
                   "value_type": "list"
               },
               {
                   "id": "PACKAGE_HEIGHT",
                   "name": "Package height",
                   "value_id": null,
                   "value_name": "30 cm",
                   "value_struct": {
                       "number": 30,
                       "unit": "cm"
                   },
                   "values": [
                       {
                           "id": null,
                           "name": "30 cm",
                           "struct": {
                               "number": 30,
                               "unit": "cm"
                           }
                       }
                   ],
                   "value_type": "number_unit"
               },
               {
                   "id": "PACKAGE_LENGTH",
                   "name": "Package length",
                   "value_id": null,
                   "value_name": "30 cm",
                   "value_struct": {
                       "number": 30,
                       "unit": "cm"
                   },
                   "values": [
                       {
                           "id": null,
                           "name": "30 cm",
                           "struct": {
                               "number": 30,
                               "unit": "cm"
                           }
                       }
                   ],
                   "value_type": "number_unit"
               },
               {
                   "id": "PACKAGE_WEIGHT",
                   "name": "Package weight",
                   "value_id": null,
                   "value_name": "1 kg",
                   "value_struct": {
                       "number": 1,
                       "unit": "kg"
                   },
                   "values": [
                       {
                           "id": null,
                           "name": "1 kg",
                           "struct": {
                               "number": 1,
                               "unit": "kg"
                           }
                       }
                   ],
                   "value_type": "number_unit"
               },
               {
                   "id": "PACKAGE_WIDTH",
                   "name": "Package width",
                   "value_id": null,
                   "value_name": "30 cm",
                   "value_struct": {
                       "number": 30,
                       "unit": "cm"
                   },
                   "values": [
                       {
                           "id": null,
                           "name": "30 cm",
                           "struct": {
                               "number": 30,
                               "unit": "cm"
                           }
                       }
                   ],
                   "value_type": "number_unit"
               },
               {
                   "id": "SIZE_GRID_ROW_ID",
                   "name": "Size grid row ID",
                   "value_id": null,
                   "value_name": "467833:1",
                   "value_struct": null,
                   "values": [
                       {
                           "id": null,
                           "name": "467833:1",
                           "struct": null
                       }
                   ],
                   "value_type": "grid_row_id"
               },
               {
                   "id": "GTIN",
                   "name": "Universal product code",
                   "value_id": null,
                   "value_name": "7899680328732",
                   "value_struct": null,
                   "values": [
                       {
                           "id": null,
                           "name": "7899680328732",
                           "struct": null
                       }
                   ],
                   "value_type": "string"
               }
           ],
           "inventory_id": null,
           "item_relations": []
       },
       {
           "id": 176278545395,
           "attribute_combinations": [
               {
                   "id": "COLOR",
                   "name": "Color",
                   "value_id": "52028",
                   "value_name": "Blue",
                   "value_struct": null,
                   "values": [
                       {
                           "id": "52028",
                           "name": "Blue",
                           "struct": null
                       }
                   ],
                   "value_type": "string"
               },
               {
                   "id": "SIZE",
                   "name": "Size",
                   "value_id": null,
                   "value_name": "6 US-F",
                   "value_struct": null,
                   "values": [
                       {
                           "id": null,
                           "name": "6 US-F",
                           "struct": null
                       }
                   ],
                   "value_type": "string"
               }
           ],
           "price": 12,
           "available_quantity": 2,
           "sold_quantity": 0,
           "sale_terms": [],
           "picture_ids": [
               "862503-CBT51700450573_092022"
           ],
           "seller_custom_field": null,
           "catalog_product_id": null,
           "attributes": [
               {
                   "id": "MAIN_COLOR",
                   "name": "Main color",
                   "value_id": "2450293",
                   "value_name": "Blue",
                   "value_struct": null,
                   "values": [
                       {
                           "id": "2450293",
                           "name": "Blue",
                           "struct": null
                       }
                   ],
                   "value_type": "list"
               },
               {
                   "id": "PACKAGE_HEIGHT",
                   "name": "Package height",
                   "value_id": null,
                   "value_name": "30 cm",
                   "value_struct": {
                       "number": 30,
                       "unit": "cm"
                   },
                   "values": [
                       {
                           "id": null,
                           "name": "30 cm",
                           "struct": {
                               "number": 30,
                               "unit": "cm"
                           }
                       }
                   ],
                   "value_type": "number_unit"
               },
               {
                   "id": "PACKAGE_LENGTH",
                   "name": "Package length",
                   "value_id": null,
                   "value_name": "30 cm",
                   "value_struct": {
                       "number": 30,
                       "unit": "cm"
                   },
                   "values": [
                       {
                           "id": null,
                           "name": "30 cm",
                           "struct": {
                               "number": 30,
                               "unit": "cm"
                           }
                       }
                   ],
                   "value_type": "number_unit"
               },
               {
                   "id": "PACKAGE_WEIGHT",
                   "name": "Package weight",
                   "value_id": null,
                   "value_name": "1 kg",
                   "value_struct": {
                       "number": 1,
                       "unit": "kg"
                   },
                   "values": [
                       {
                           "id": null,
                           "name": "1 kg",
                           "struct": {
                               "number": 1,
                               "unit": "kg"
                           }
                       }
                   ],
                   "value_type": "number_unit"
               },
               {
                   "id": "PACKAGE_WIDTH",
                   "name": "Package width",
                   "value_id": null,
                   "value_name": "30 cm",
                   "value_struct": {
                       "number": 30,
                       "unit": "cm"
                   },
                   "values": [
                       {
                           "id": null,
                           "name": "30 cm",
                           "struct": {
                               "number": 30,
                               "unit": "cm"
                           }
                       }
                   ],
                   "value_type": "number_unit"
               },
               {
                   "id": "SIZE_GRID_ROW_ID",
                   "name": "Size grid row ID",
                   "value_id": null,
                   "value_name": "467833:2",
                   "value_struct": null,
                   "values": [
                       {
                           "id": null,
                           "name": "467833:2",
                           "struct": null
                       }
                   ],
                   "value_type": "grid_row_id"
               },
               {
                   "id": "GTIN",
                   "name": "Universal product code",
                   "value_id": null,
                   "value_name": "7899680328732",
                   "value_struct": null,
                   "values": [
                       {
                           "id": null,
                           "name": "7899680328732",
                           "struct": null
                       }
                   ],
                   "value_type": "string"
               }
           ],
           "inventory_id": null,
           "item_relations": []
       }
   ],
   "thumbnail_id": "644516-CBT51699767208_092022",
   "thumbnail": "http://cbt-s1-p.mlstatic.com/644516-CBT51699767208_092022-I.jpg",
   "secure_thumbnail": "https://cbt-s1-p.mlstatic.com/644516-CBT51699767208_092022-I.jpg",
   "status": "active",
   "sub_status": [],
   "tags": [
       "immediate_payment",
       "test_item"
   ],
   "warranty": "No warranty",
   "catalog_product_id": null,
   "domain_id": "CBT-SNEAKERS",
   "seller_custom_field": null,
   "parent_item_id": null,
   "differential_pricing": null,
   "deal_ids": [],
   "automatic_relist": false,
   "date_created": "2023-01-03T13:40:09.134Z",
   "last_updated": "2023-01-03T13:40:09.134Z",
   "health": null,
   "catalog_listing": false,
   "item_relations": [],
   "channels": [
       "marketplace"
   ]
}

2. The creation of marketplace items works as normal

The publication result in Mercado Libre is that:



3. Associate size chart

Considerations

The size_grid_id and size_grid_row_id fields are new attributes in the payload at item creation.


  • size_grid_id: is the id of the size chart that was created.
  • size_grid_row: is the id of the grid row.
  • The user that creates the item must be the same one that created the chart.
  • The chart gender must be corresponding to item gender.
  • It is not possible to associate a chart without row_id associated.

Request:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json"
https://api.mercadolibre.com/items/CBT1562767341

    "attributes": [
        {
            "id" :"SIZE_GRID_ID",
            "value_name": "457209"
        }
    ],
    "variations": [
        {
            "id": "175953728075",
            "attributes": [
                {
                    "id" :"SIZE_GRID_ROW_ID",
                    "value_name": "457209:1"
                }
            ]
        }
    ]
}

Response:

{
    "id": "CBT1562767341",
    "site_id": "CBT",
    "title": "Black Flats",
    "subtitle": null,
    "seller_id": 1161438226,
    "category_id": "CBT415192",
    "official_store_id": null,
    "price": 19,
    "base_price": 19,
    "original_price": null,
    "inventory_id": null,
    "currency_id": "USD",
    "initial_quantity": 78,
    "available_quantity": 78,
    "sold_quantity": 0,
    "sale_terms": [
        {
            "id": "WARRANTY_TYPE",
            "name": "Warranty type",
            "value_id": "6150835",
            "value_name": "No warranty",
            "value_struct": null,
            "values": [
                {
                    "id": "6150835",
                    "name": "No warranty",
                    "struct": null
                }
            ],
            "value_type": "list"
        }
    ],
    "buying_mode": "buy_it_now",
    "listing_type_id": "gold_pro",
    "start_time": "2022-11-29T21:53:46.000Z",
    "historical_start_time": "2022-11-29T21:53:46.000Z",
    "stop_time": "2042-11-24T04:00:00.000Z",
    "end_time": "2042-11-24T04:00:00.000Z",
    "expiration_time": "2023-03-02T16:10:47.201Z",
    "condition": "new",
    "permalink": "",
    "pictures": [
        {
            "id": "654109-CBT52650003376_112022",
            "url": "http://cbt-s1-p.mlstatic.com/654109-CBT52650003376_112022-O.jpg",
            "secure_url": "https://cbt-s1-p.mlstatic.com/654109-CBT52650003376_112022-O.jpg",
            "size": "433x500",
            "max_size": "550x634",
            "quality": ""
        }
    ],
    "video_id": null,
    "descriptions": [],
    "accepts_mercadopago": true,
    "non_mercado_pago_payment_methods": [],
    "shipping": {
        "mode": "not_specified",
        "local_pick_up": false,
        "free_shipping": false,
        "methods": [],
        "dimensions": null,
        "tags": [],
        "logistic_type": "not_specified",
        "store_pick_up": false
    },
    "international_delivery_mode": "none",
    "seller_address": {
        "id": 1243708104,
        "comment": "",
        "address_line": "No.1003 shennandadao road, futian District",
        "zip_code": "518033",
        "city": {
            "id": "Q04tR0RTaGVuemhlbg",
            "name": "Shenzhen"
        },
        "state": {
            "id": "CN-GD",
            "name": "Guangdong"
        },
        "country": {
            "id": "CN",
            "name": "China"
        },
        "latitude": "",
        "longitude": "",
        "search_location": {
            "neighborhood": {
                "id": "",
                "name": ""
            },
            "city": {
                "id": "",
                "name": ""
            },
            "state": {
                "id": "",
                "name": ""
            }
        }
    },
    "seller_contact": null,
    "location": {},
    "geolocation": {
        "latitude": "",
        "longitude": ""
    },
    "coverage_areas": [],
    "attributes": [
        {
            "id": "SIZE_GRID_ID",
            "name": "Size grid ID",
            "value_id": null,
            "value_name": "457209",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "457209",
                    "struct": null
                }
            ],
            "attribute_group_id": "",
            "attribute_group_name": "",
            "value_type": "string"
        },
        {
            "id": "FOOTWEAR_TYPE",
            "name": "Footwear type",
            "value_id": "4102827",
            "value_name": "Flats",
            "value_struct": null,
            "values": [
                {
                    "id": "4102827",
                    "name": "Flats",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Others",
            "value_type": "string"
        },
        {
            "id": "MODEL",
            "name": "Model",
            "value_id": null,
            "value_name": "Flat",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "Flat",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Others",
            "value_type": "string"
        },
        {
            "id": "BRAND",
            "name": "Brand",
            "value_id": "10331273",
            "value_name": "Generic",
            "value_struct": null,
            "values": [
                {
                    "id": "10331273",
                    "name": "Generic",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Others",
            "value_type": "string"
        },
        {
            "id": "GENDER",
            "name": "Gender",
            "value_id": "339665",
            "value_name": "Woman",
            "value_struct": null,
            "values": [
                {
                    "id": "339665",
                    "name": "Woman",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Others",
            "value_type": "list"
        },
        {
            "id": "ITEM_CONDITION",
            "name": "Item condition",
            "value_id": "2230284",
            "value_name": "New",
            "value_struct": null,
            "values": [
                {
                    "id": "2230284",
                    "name": "New",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Others",
            "value_type": "list"
        }
    ],
    "warnings": [],
    "listing_source": "",
    "variations": [
        {
            "id": 175953728075,
            "attribute_combinations": [
                {
                    "id": "COLOR",
                    "name": "Color",
                    "value_id": "52049",
                    "value_name": "Black",
                    "value_struct": null,
                    "values": [
                        {
                            "id": "52049",
                            "name": "Black",
                            "struct": null
                        }
                    ],
                    "value_type": "string"
                },
                {
                    "id": "SIZE",
                    "name": "Size",
                    "value_id": null,
                    "value_name": "18.0",
                    "value_struct": null,
                    "values": [
                        {
                            "id": null,
                            "name": "18.0",
                            "struct": null
                        }
                    ],
                    "value_type": "string"
                }
            ],
            "price": 19,
            "available_quantity": 78,
            "sold_quantity": 0,
            "sale_terms": [],
            "picture_ids": [
                "654109-CBT52650003376_112022"
            ],
            "seller_custom_field": null,
            "catalog_product_id": null,
            "attributes": [
                {
                    "id": "MAIN_COLOR",
                    "name": "Main color",
                    "value_id": "2450295",
                    "value_name": "Black",
                    "value_struct": null,
                    "values": [
                        {
                            "id": "2450295",
                            "name": "Black",
                            "struct": null
                        }
                    ],
                    "value_type": "list"
                },
                {
                    "id": "PACKAGE_HEIGHT",
                    "name": "Package height",
                    "value_id": null,
                    "value_name": "15 cm",
                    "value_struct": {
                        "number": 15,
                        "unit": "cm"
                    },
                    "values": [
                        {
                            "id": null,
                            "name": "15 cm",
                            "struct": {
                                "number": 15,
                                "unit": "cm"
                            }
                        }
                    ],
                    "value_type": "number_unit"
                },
                {
                    "id": "PACKAGE_LENGTH",
                    "name": "Package length",
                    "value_id": null,
                    "value_name": "15 cm",
                    "value_struct": {
                        "number": 15,
                        "unit": "cm"
                    },
                    "values": [
                        {
                            "id": null,
                            "name": "15 cm",
                            "struct": {
                                "number": 15,
                                "unit": "cm"
                            }
                        }
                    ],
                    "value_type": "number_unit"
                },
                {
                    "id": "PACKAGE_WEIGHT",
                    "name": "Package weight",
                    "value_id": null,
                    "value_name": "400 g",
                    "value_struct": {
                        "number": 400,
                        "unit": "g"
                    },
                    "values": [
                        {
                            "id": null,
                            "name": "400 g",
                            "struct": {
                                "number": 400,
                                "unit": "g"
                            }
                        }
                    ],
                    "value_type": "number_unit"
                },
                {
                    "id": "PACKAGE_WIDTH",
                    "name": "Package width",
                    "value_id": null,
                    "value_name": "25 cm",
                    "value_struct": {
                        "number": 25,
                        "unit": "cm"
                    },
                    "values": [
                        {
                            "id": null,
                            "name": "25 cm",
                            "struct": {
                                "number": 25,
                                "unit": "cm"
                            }
                        }
                    ],
                    "value_type": "number_unit"
                },
                {
                    "id": "SIZE_GRID_ROW_ID",
                    "name": "Size grid row ID",
                    "value_id": null,
                    "value_name": "457209:1",
                    "value_struct": null,
                    "values": [
                        {
                            "id": null,
                            "name": "457209:1",
                            "struct": null
                        }
                    ],
                    "value_type": "string"
                },
                {
                    "id": "GTIN",
                    "name": "Universal product code",
                    "value_id": null,
                    "value_name": "744960894766",
                    "value_struct": null,
                    "values": [
                        {
                            "id": null,
                            "name": "744960894766",
                            "struct": null
                        }
                    ],
                    "value_type": "string"
                }
            ],
            "inventory_id": null,
            "item_relations": []
        }
    ],
    "thumbnail_id": "654109-CBT52650003376_112022",
    "thumbnail": "http://cbt-s1-p.mlstatic.com/654109-CBT52650003376_112022-I.jpg",
    "secure_thumbnail": "https://cbt-s1-p.mlstatic.com/654109-CBT52650003376_112022-I.jpg",
    "status": "active",
    "sub_status": [],
    "tags": [
        "immediate_payment",
        "test_item"
    ],
    "warranty": "No warranty",
    "catalog_product_id": null,
    "domain_id": "CBT-FLATS",
    "seller_custom_field": null,
    "parent_item_id": null,
    "differential_pricing": null,
    "deal_ids": [],
    "automatic_relist": false,
    "date_created": "2022-11-29T21:53:46.000Z",
    "last_updated": "2022-12-12T16:10:47.228Z",
    "total_listing_fee": null,
    "health": null,
    "catalog_listing": false,
    "item_relations": [],
    "channels": [
        "marketplace"
    ],
    "bundle": null,
    "fee": 0,
    "client_id": 4954751883138633,
    "sale_fee": 0
}