Last update 07/03/2023

Validations

Important:
This resource is available for Mexico and Brazil.

Our goal is to improve the experience on the site. For this reason, we have made available the size chart, where sellers of fashion can give more details of the measurements of their products to buyers. This way, the seller can decrease the number of questions, returns due to size problems, and increase sales. Review the documentation to see how to validate a size chart.

Summary recommendations for fashion listings

  • Complete the technical sheet for the item.
  • Review genders by country using the /catalog_domains/$DOMAIN_ID/attributes/GENDER resource so that your listings reference genders are recognized by the Mercado Libre.
  • Upload all the required attributes, as well as variations in your listings.
  • Identify if any quality requirements are not complied and take the necessary actions.
  • Confirm if the domain has attributes configured for the size chart. When you find an attribute of type GRID_ID and GRID_ROW_ID you will recognize that for this domain the size chart is required, and will not allow you to create or modify it without having the size chart loaded correctly.

Define fashion domain to publish

To advance in the publication flow of a fashion article with an associated size chart, it is necessary to run the category predictor through the /domain_discovery resource to obtain the domain_id data on which it will be published.


Response:

[
   {
       "domain_id": "CBT-BABIES_FOOTWEAR",
       "domain_name": "Babies footwear",
       "category_id": "CBT1397",
       "category_name": "Shoes",
       "attributes": []
   },
   {
       "domain_id": "CBT-SNEAKERS",
       "domain_name": "Sneakers",
       "category_id": "CBT109027",
       "category_name": "Sports Shoes",
       "attributes": []
   }
]

Domains with uploaded size charts

This resource aims to inform the domains that have size charts created (SPECIFIC type) for a specific site. You must send in the body of the POST the filter type=SPECIFIC and the corresponding site.

Important:
Specific charts can only be used by the seller who created them and associated with items from this seller. We don’t recommend using this resource to recognise the domains available for assigning size charts to an item, for this you must use the resource of Available domains for size chart.

Request:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d https://api.mercadolibre.com/catalog/charts/domains/search
{
    "site_id": "CBT",
    "type": "SPECIFIC"
}

Response:

 "domains": [
        {
            "domain_id": "SNEAKERS"
        },
        {
            "domain_id": "BOOTS_AND_BOOTIES"
        },
        {
            "domain_id": "SANDALS_AND_CLOGS"
        },
        {
            "domain_id": "LOAFERS_AND_OXFORDS"
        },
        {
            "domain_id": "FOOTBALL_SHOES"
        }
    ]
 }

Consult domain data sheet

Once the category and domain have been identified for the publication, you must consult the /domains/$domain_id/technical_specs resource and consult the domain's data sheet, recognizing the attributes with value_type: grid_id and grid_row_id that will allow you to identify if the domain requires a size chart.
Additionally, you will have to recognize those attributes with the grid_template_required tag which will be required for the size chart data sheet search.


Note:
From now on, size charts will have a technical file, which is defined according to the domain of the item. Based on this data sheet, it is defined what information must be taken into account when creating the size chart.

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/domains/$DOMAIN_ID/technical_specs

Example consulting the CBT-SNEAKERS domain data sheet:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/domains/CBT-SNEAKERS/technical_specs

Response with the details of the domain's datasheet:


{
    "input": {
        "groups": [
            {
                "id": "MAIN",
                "label": "Características principales",
                "relevance": 1,
                "section": "SPECIFICATIONS",
                "ui_config": {},
                "components": [
                    {
                        "component": "COMBO",
                        "label": "Brand",
                        "ui_config": {
                            "hint": "Indicate the actual brand of the product or 'Generic' if it has no brand.",
                            "allow_custom_value": true,
                            "allow_filtering": true
                        },
                        "attributes": [
                            {
                                "id": "BRAND",
                                "name": "Brand",
                                "value_type": "string",
                                "value_max_length": 255,
                                "tags": [
                                    "grid_filter",
                                    "catalog_required",
                                    "required"
                                ],
                                "values": [...],
                        "unified_units": []
                    },
                    {
                        "component": "TEXT_INPUT",
                        "label": "Line",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": false
                        },
                        "attributes": [
                            {
                                "id": "LINE",
                                "name": "Line",
                                "value_type": "string",
                                "value_max_length": 255,
                                "tags": [
                                    "hidden"
                                ],
                                "hierarchy": "PARENT_PK",
                                "relevance": 1
                            }
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "TEXT_INPUT",
                        "label": "Model",
                        "ui_config": {
                            "tooltip": "It is the product specific name.",
                            "allow_custom_value": false,
                            "allow_filtering": false
                        },
                        "attributes": [
                            {
                                "id": "MODEL",
                                "name": "Model",
                                "value_type": "string",
                                "value_max_length": 255,
                                "tags": [
                                    "catalog_required",
                                    "required"
                                ],
                                "hierarchy": "PARENT_PK",
                                "relevance": 1
                            }
                        ],
                        "unified_units": []
                    }...
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "COMBO",
                        "label": "Gender",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": true
                        },
                        "attributes": [
                            {
                                "id": "GENDER",
                                "name": "Gender",
                                "value_type": "list",
                                "tags": [
                                    "grid_template_required",
                                    "grid_filter",
                                    "catalog_required",
                                    "required"
                                ],
                                "values": [
                                    {
                                        "id": "339665",
                                        "name": "Woman"
                                    }...
                                ],
                                "hierarchy": "PARENT_PK",
                                "relevance": 1
                            }
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "COMBO",
                        "label": "Age group",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": true
                        },
                        "attributes": [
                            {
                                "id": "AGE_GROUP",
                                "name": "Age group",
                                "value_type": "list",
                                "tags": [
                                    "hidden",
                                    "read_only",
                                    "grid_filter"
                                ],
                                "values": [...],
                        "unified_units": []
                    },
                    {
                        "component": "TEXT_INPUT",
                        "label": "Alphanumeric model",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": false
                        },
                        "attributes": [
                            {
                                "id": "ALPHANUMERIC_MODEL",
                                "name": "Alphanumeric model",
                                "value_type": "string",
                                "value_max_length": 255,
                                "tags": [
                                    "hidden"
                                ],
                                "hierarchy": "PARENT_PK",
                                "relevance": 1
                            }
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "COLOR_INPUT",
                        "label": "Color",
                        "ui_config": {
                            "connector": ""
                        },
                        "attributes": [
                            {
                                "id": "COLOR",
                                "name": "Color",
                                "value_type": "string",
                                "value_max_length": 255,
                                "tags": [
                                    "defines_picture",
                                    "allow_variations",
                                    "required"
                                ],
                                "values": [
                                    {
                                        "id": "52019",
                                        "name": "Dark green"
                                    }...
                                ],
                                "hierarchy": "CHILD_PK",
                                "relevance": 1
                            },
                            {
                                "id": "MAIN_COLOR",
                                "name": "Main color",
                                "value_type": "list",
                                "tags": [
                                    "vip_hidden",
                                    "variation_attribute"
                                ],
                                "values": [
                                    {
                                        "id": "2450295",
                                        "name": "Black",
                                        "metadata": {
                                            "rgb": "000000"
                                        }
                                    },
                                    ...
                                ],
                                "hierarchy": "CHILD_DEPENDENT",
                                "relevance": 1
                            }
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "COMBO",
                        "label": "Fabric design",
                        "ui_config": {
                            "allow_custom_value": true,
                            "allow_filtering": true
                        },
                        "attributes": [
                            {
                                "id": "FABRIC_DESIGN",
                                "name": "Fabric design",
                                "value_type": "string",
                                "value_max_length": 255,
                                "tags": [
                                    "defines_picture",
                                    "allow_variations"
                                ],
                                "values": [...],
                        "unified_units": []
                    },
                    {
                        "component": "COMBO",
                        "label": "Width type",
                        "ui_config": {
                            "allow_custom_value": true,
                            "allow_filtering": true
                        },
                        "attributes": [...],
                                "hierarchy": "CHILD_PK",
                                "relevance": 1
                            }
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "GRID_ROW_INPUT",
                        "label": "Size grid row ID",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": false
                        },
                        "attributes": [
                            {
                                "id": "SIZE_GRID_ROW_ID",
                                "name": "Size grid row ID",
                                "value_type": "grid_row_id",
                                "value_max_length": 255,
                                "tags": [
                                    "vip_hidden",
                                    "hidden",
                                    "variation_attribute"
                                ],
                                "hierarchy": "CHILD_PK",
                                "relevance": 1
                            }
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "COMBO",
                        "label": "Size",
                        "ui_config": {
                            "allow_custom_value": true,
                            "allow_filtering": true
                        },
                        "attributes": [
                            {
                                "id": "SIZE",
                                "name": "Size",
                                "value_type": "string",
                                "value_max_length": 255,
                                "tags": [
                                    "allow_variations",
                                    "required"
                                ],
                                "values": [
                                    {
                                        "id": "6367305",
                                        "name": "Only"
                                    },
                                    {
                                        "id": "3259490",
                                        "name": "Custom made"
                                    }
                                ],
                                "hierarchy": "CHILD_PK",
                                "relevance": 1
                            }
                        ],
                        "unified_units": []
                    }
                ]
            },
            {
                "id": "OTHER",
                "label": "Otros",
                "relevance": 1,
                "section": "SPECIFICATIONS",
                "ui_config": {},
                "components": [
                    {...}
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "NUMBER_UNIT_INPUT",
                        "label": "Package height",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": false
                        },
                        "attributes": [
                            {
                                "id": "PACKAGE_HEIGHT",
                                "name": "Package height",
                                "value_type": "number_unit",
                                "value_max_length": 255,
                                "tags": [
                                    "vip_hidden",
                                    "variation_attribute",
                                    "required"
                                ],
                                "default_unit_id": "cm",
                                "units": [...],
                                "hierarchy": "CHILD_DEPENDENT",
                                "relevance": 1
                            }
                        ],
                        "default_unified_unit_id": "cm",
                        "unified_units": [
                            {
                                "id": "mm",
                                "name": "mm"
                            },
                            {
                                "id": "cm",
                                "name": "cm"
                            },
                            {
                                "id": "m",
                                "name": "m"
                            },
                            {
                                "id": "\"",
                                "name": "\""
                            },
                            {
                                "id": "ft",
                                "name": "ft"
                            }
                        ]
                    },
                    {
                        "component": "NUMBER_UNIT_INPUT",
                        "label": "Package width",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": false
                        },
                        "attributes": [
                            {
                                "id": "PACKAGE_WIDTH",
                                "name": "Package width",
                                "value_type": "number_unit",
                                "value_max_length": 255,
                                "tags": [
                                    "vip_hidden",
                                    "variation_attribute",
                                    "required"
                                ],
                                "default_unit_id": "cm",
                                "units": [
                                    {
                                        "id": "mm",
                                        "name": "mm"
                                    },
                                    {
                                        "id": "cm",
                                        "name": "cm"
                                    },
                                    {
                                        "id": "m",
                                        "name": "m"
                                    },
                                    {
                                        "id": "\"",
                                        "name": "\""
                                    },
                                    {
                                        "id": "ft",
                                        "name": "ft"
                                    }
                                ],
                                "hierarchy": "CHILD_DEPENDENT",
                                "relevance": 1
                            }
                        ],
                        "default_unified_unit_id": "cm",
                        "unified_units": [
                            {
                                "id": "mm",
                                "name": "mm"
                            },
                            {
                                "id": "cm",
                                "name": "cm"
                            },
                            {
                                "id": "m",
                                "name": "m"
                            },
                            {
                                "id": "\"",
                                "name": "\""
                            },
                            {
                                "id": "ft",
                                "name": "ft"
                            }
                        ]
                    },
                    {
                        "component": "NUMBER_UNIT_INPUT",
                        "label": "Package length",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": false
                        },
                        "attributes": [
                            {
                                "id": "PACKAGE_LENGTH",
                                "name": "Package length",
                                "value_type": "number_unit",
                                "value_max_length": 255,
                                "tags": [
                                    "vip_hidden",
                                    "variation_attribute",
                                    "required"
                                ],
                                "default_unit_id": "cm",
                                "units": [
                                    {
                                        "id": "mm",
                                        "name": "mm"
                                    },
                                    {
                                        "id": "cm",
                                        "name": "cm"
                                    },
                                    {
                                        "id": "m",
                                        "name": "m"
                                    },
                                    {
                                        "id": "\"",
                                        "name": "\""
                                    },
                                    {
                                        "id": "ft",
                                        "name": "ft"
                                    }
                                ],
                                "hierarchy": "CHILD_DEPENDENT",
                                "relevance": 1
                            }
                        ],
                        "default_unified_unit_id": "cm",
                        "unified_units": [
                            {
                                "id": "mm",
                                "name": "mm"
                            },
                            {
                                "id": "cm",
                                "name": "cm"
                            },
                            {
                                "id": "m",
                                "name": "m"
                            },
                            {
                                "id": "\"",
                                "name": "\""
                            },
                            {
                                "id": "ft",
                                "name": "ft"
                            }
                        ]
                    },
                    {
                        "component": "NUMBER_UNIT_INPUT",
                        "label": "Package weight",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": false
                        },
                        "attributes": [
                            {
                                "id": "PACKAGE_WEIGHT",
                                "name": "Package weight",
                                "value_type": "number_unit",
                                "value_max_length": 255,
                                "tags": [...],
                                "default_unit_id": "g",
                                "units": [
                                    {
                                        "id": "mg",
                                        "name": "mg"
                                    },
                                    {
                                        "id": "g",
                                        "name": "g"
                                    },
                                    {
                                        "id": "kg",
                                        "name": "kg"
                                    },
                                    {
                                        "id": "lb",
                                        "name": "lb"
                                    },
                                    {
                                        "id": "oz",
                                        "name": "oz"
                                    }
                                ],
                                "hierarchy": "CHILD_DEPENDENT",
                                "relevance": 1
                            }
                        ],
                        "default_unified_unit_id": "g",
                        "unified_units": [
                            {
                                "id": "mg",
                                "name": "mg"
                            },
                            {
                                "id": "g",
                                "name": "g"
                            },
                            {
                                "id": "kg",
                                "name": "kg"
                            },
                            {
                                "id": "lb",
                                "name": "lb"
                            },
                            {
                                "id": "oz",
                                "name": "oz"
                            }
                        ]
                    },
                    {
                        "component": "GRID_INPUT",
                        "label": "Size grid ID",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": false
                        },
                        "attributes": [
                            {
                                "id": "SIZE_GRID_ID",
                                "name": "Size grid ID",
                                "value_type": "grid_id",
                                "value_max_length": 255,
                                "tags": [
                                    "vip_hidden"
                                ],
                                "hierarchy": "FAMILY",
                                "relevance": 1
                            }
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "COMBO",
                        "label": "Style",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": true
                        },
                        "attributes": [
                            {
                                "id": "STYLE",
                                "name": "Style",
                                "value_type": "list",
                                "tags": [
                                    "required"
                                ],
                                "values": [
                                    {
                                        "id": "6694772",
                                        "name": "Sport"
                                    },
                                    {
                                        "id": "6694773",
                                        "name": "Urban"
                                    }
                                ],
                                "hierarchy": "FAMILY",
                                "relevance": 1
                            }
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "COMBO",
                        "label": "Recommended sports",
                        "ui_config": {
                            "tooltip": "It is the sport for which the product was designed.",
                            "allow_custom_value": true,
                            "allow_filtering": true,
                            "example": "Running; Trekking; Soccer; Tennis; Swimming; Hockey"
                        },
                        "attributes": [
                            {
                                "id": "RECOMMENDED_SPORTS",
                                "name": "Recommended sports",
                                "value_type": "string",
                                "value_max_length": 255,
                                "tags": [
                                    "multivalued",
                                    "grid_filter"
                                ],
                                "values": [...],
                                "hierarchy": "FAMILY",
                                "relevance": 1
                            }
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "COMBO",
                        "label": "Exterior materials",
                        "ui_config": {
                            "tooltip": "These are the materials of the external part of the product.",
                            "allow_custom_value": true,
                            "allow_filtering": true,
                            "example": "Leather; Polycarbonate; Plastic; Fabric"
                        },
                        "attributes": [...],
                        "unified_units": []
                    },
                    {
                        "component": "COMBO",
                        "label": "Interior materials",
                        "ui_config": {
                            "allow_custom_value": true,
                            "allow_filtering": true
                        },
                        "attributes": [
                            {
                                "id": "INTERIOR_MATERIALS",
                                "name": "Interior materials",
                                "value_type": "string",
                                "value_max_length": 255,
                                "tags": [
                                    "multivalued"
                                ],
                                "values": [...],
                        "unified_units": []
                    },
                    {
                        "component": "COMBO",
                        "label": "Outsole materials",
                        "ui_config": {
                            "allow_custom_value": true,
                            "allow_filtering": true,
                            "example": "Rubber; Plastic; Aluminum; Polyurethane"
                        },
                        "attributes": [...],
                        "unified_units": []
                    },
                    {
                        "component": "COMBO",
                        "label": "Footwear technologies",
                        "ui_config": {
                            "allow_custom_value": true,
                            "allow_filtering": true,
                            "example": "Cloudfoam"
                        },
                        "attributes": [
                            {
                                "id": "FOOTWEAR_TECHNOLOGIES",
                                "name": "Footwear technologies",
                                "value_type": "string",
                                "value_max_length": 255,
                                "tags": [
                                    "hidden",
                                    "multivalued"
                                ],
                                "values": [
                                    {
                                        "id": "5913148",
                                        "name": "Pureboost"
                                    },
                                    {
                                        "id": "5913149",
                                        "name": "Ultraboost"
                                    }
                                ],
                                "hierarchy": "FAMILY",
                                "relevance": 1
                            }
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "COMBO",
                        "label": "Footwear type",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": true
                        },
                        "attributes": [...],
                                "hierarchy": "FAMILY",
                                "relevance": 1
                            }
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "COMBO",
                        "label": "Adjustment types",
                        "ui_config": {
                            "allow_custom_value": true,
                            "allow_filtering": true,
                            "example": "Shoelaces"
                        },
                        "attributes": [...],
                        "unified_units": []
                    },
                    {
                        "component": "TEXT_INPUT",
                        "label": "Universal product code",
                        "ui_config": {
                            "hint": "It may be an EAN, UPC or another GTIN.",
                            "tooltip": "How do I find it?\n\nIt is the number that identifies a product globally and has between 8 and 14 digits. Look for it on the packaging or label, next to the bar code. You must add a code for each variation. If you can not find it, you can ask the manufacturer or use a code search engine on the internet.",
                            "allow_custom_value": false,
                            "allow_filtering": false
                        },
                        "attributes": [
                            {
                                "id": "GTIN",
                                "name": "Universal product code",
                                "value_type": "string",
                                "value_max_length": 255,
                                "tags": [
                                    "vip_hidden",
                                    "multivalued",
                                    "used_hidden",
                                    "variation_attribute",
                                    "required",
                                    "validate"
                                ],
                                "hierarchy": "PRODUCT_IDENTIFIER",
                                "relevance": 1
                            }
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "NUMBER_UNIT_INPUT",
                        "label": "Foot width",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": false
                        },
                        "attributes": [
                            {
                                "id": "FOOT_WIDTH",
                                "name": "Foot width",
                                "value_type": "number_unit",
                                "value_max_length": 255,
                                "tags": [
                                    "hidden",
                                    "variation_attribute"
                                ],
                                "default_unit_id": "cm",
                                "units": [
                                    {
                                        "id": "\"",
                                        "name": "\""
                                    },
                                    {
                                        "id": "cm",
                                        "name": "cm"
                                    }
                                ],
                                "hierarchy": "CHILD_DEPENDENT",
                                "relevance": 2
                            }
                        ],
                        "default_unified_unit_id": "cm",
                        "unified_units": [
                            {
                                "id": "\"",
                                "name": "\""
                            },
                            {
                                "id": "cm",
                                "name": "cm"
                            }
                        ]
                    },
                    {
                        "component": "NUMBER_UNIT_INPUT",
                        "label": "Footwear weight",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": false
                        },
                        "attributes": [...],
                        "default_unified_unit_id": "g",
                        "unified_units": [
                            {
                                "id": "g",
                                "name": "g"
                            }
                        ]
                    },
                    {
                        "component": "COMBO",
                        "label": "Exterior composition",
                        "ui_config": {
                            "allow_custom_value": true,
                            "allow_filtering": true
                        },
                        "attributes": [
                            {
                                "id": "EXTERIOR_COMPOSITION",
                                "name": "Exterior composition",
                                "value_type": "string",
                                "value_max_length": 255,
                                "tags": [
                                    "hidden",
                                    "multivalued"
                                ],
                                "values": [
                                    {
                                        "id": "11098228",
                                        "name": "80% canvas"
                                    },
                                    {
                                        "id": "11098229",
                                        "name": "40% leather"
                                    }
                                ],
                                "hierarchy": "FAMILY",
                                "relevance": 2
                            }
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "COMBO",
                        "label": "Outsole composition",
                        "ui_config": {
                            "allow_custom_value": true,
                            "allow_filtering": true
                        },
                        "attributes": [...],
                                "values": [
                                    {
                                        "id": "11098230",
                                        "name": "80% EVA foam"
                                    },
                                    {
                                        "id": "11098231",
                                        "name": "40% polyurethane"
                                    }
                                ],
                                "hierarchy": "FAMILY",
                                "relevance": 2
                            }
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "BOOLEAN_INPUT",
                        "label": "Is",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": true
                        },
                        "attributes": [
                            {
                                "id": "IS_IMPERMEABLE",
                                "name": "Impermeable",
                                "value_type": "boolean",
                                "tags": [
                                    "hidden"
                                ],
                                "values": [
                                    {
                                        "id": "242084",
                                        "name": "No",
                                        "metadata": {
                                            "value": false
                                        }
                                    },
                                    {...}
                                    }
                                ],
                                "hierarchy": "FAMILY",
                                "relevance": 2
                            }
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "BOOLEAN_INPUT",
                        "label": "With",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": true
                        },
                        "attributes": [
                            {
                                "id": "WITH_ANTI_SLIP_OUTSOLE",
                                "name": "Anti-slip outsole",
                                "value_type": "boolean",
                                "tags": [
                                    "hidden"
                                ],
                                "values": [
                                    {
                                        "id": "242084",
                                        "name": "No",
                                        "metadata": {
                                            "value": false
                                        }
                                    },
                                    {
                                        "id": "242085",
                                        "name": "Yes",
                                        "metadata": {
                                            "value": true
                                        }
                                    }
                                ],
                                "hierarchy": "FAMILY",
                                "relevance": 2
                            }
                        ],
                        "unified_units": []
                    },
                    {...},
                        "attributes": [
                            {
                                "id": "WITH_REMOVABLE_INSOLES",
                                "name": "Removable insoles",
                                "value_type": "boolean",
                                "tags": [
                                    "hidden"
                                ],
                                "values": [...],
                                "hierarchy": "FAMILY",
                                "relevance": 2
                            }
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "BOOLEAN_INPUT",
                        "label": "With",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": true
                        },
                        "attributes": [
                            {
                                "id": "WITH_BREATHEABLE_INSOLES",
                                "name": "Breatheable insoles",
                                "value_type": "boolean",
                                "tags": [
                                    "hidden"
                                ],
                                "values": [
                                    {
                                        "id": "242084",
                                        "name": "No",
                                        "metadata": {
                                            "value": false
                                        }
                                    },
                                    {
                                        "id": "242085",
                                        "name": "Yes",
                                        "metadata": {
                                            "value": true
                                        }
                                    }
                                ],
                                "hierarchy": "FAMILY",
                                "relevance": 2
                            }
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "COMBO",
                        "label": "Insoles materials",
                        "ui_config": {
                            "allow_custom_value": true,
                            "allow_filtering": true,
                            "example": "Cloth; Foam"
                        },
                        "attributes": [
                            {
                                "id": "INSOLES_MATERIALS",
                                "name": "Insoles materials",
                                "value_type": "string",
                                "value_max_length": 255,
                                "tags": [
                                    "hidden",
                                    "multivalued"
                                ],
                                "values": [...],
                                "hierarchy": "FAMILY",
                                "relevance": 2
                            }
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "COMBO",
                        "label": "Shaft type",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": true
                        },
                        "attributes": [
                            {
                                "id": "SHAFT_TYPE",
                                "name": "Shaft type",
                                "value_type": "list",
                                "tags": [
                                    "hidden"
                                ],
                                "values": [
                                    {
                                        "id": "1164225",
                                        "name": "High"
                                    },
                                    {
                                        "id": "1164226",
                                        "name": "Low"
                                    },
                                    {
                                        "id": "1164227",
                                        "name": "Medium"
                                    }
                                ],
                                "hierarchy": "FAMILY",
                                "relevance": 2
                            }
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "COMBO",
                        "label": "Midsole materials",
                        "ui_config": {
                            "allow_custom_value": true,
                            "allow_filtering": true
                        },
                        "attributes": [
                            {
                                "id": "MIDSOLE_MATERIALS",
                                "name": "Midsole materials",
                                "value_type": "string",
                                "value_max_length": 255,
                                "tags": [
                                    "hidden",
                                    "multivalued"
                                ],
                                "values": [...],
                                "hierarchy": "FAMILY",
                                "relevance": 2
                            }
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "BOOLEAN_INPUT",
                        "label": "With",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": true
                        },
                        "attributes": [
                            {
                                "id": "WITH_PADDED_MIDSOLE",
                                "name": "Padded midsole",
                                "value_type": "boolean",
                                "tags": [
                                    "hidden"
                                ],
                                "values": [...],
                                "hierarchy": "FAMILY",
                                "relevance": 2
                            }
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "BOOLEAN_INPUT",
                        "label": "With",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": true
                        },
                        "attributes": [
                            {
                                "id": "WITH_PADDED_TONGUE",
                                "name": "Padded tongue",
                                "value_type": "boolean",
                                "tags": [
                                    "hidden"
                                ],
                                "values": [
                                    {
                                        "id": "242084",
                                        "name": "No",
                                        "metadata": {
                                            "value": false
                                        }
                                    },
                                    {
                                        "id": "242085",
                                        "name": "Yes",
                                        "metadata": {
                                            "value": true
                                        }
                                    }
                                ],
                                "hierarchy": "FAMILY",
                                "relevance": 2
                            }
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "BOOLEAN_INPUT",
                        "label": "With",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": true
                        },
                        "attributes": [
                            {
                                "id": "WITH_PADDED_COLLAR",
                                "name": "Padded collar",
                                "value_type": "boolean",
                                "tags": [
                                    "hidden"
                                ],
                                "values": [...],
                                "hierarchy": "FAMILY",
                                "relevance": 2
                            }
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "COMBO",
                        "label": "Suitable surfaces",
                        "ui_config": {
                            "allow_custom_value": true,
                            "allow_filtering": true
                        },
                        "attributes": [...],
                                "hierarchy": "FAMILY",
                                "relevance": 2
                            }
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "COMBO",
                        "label": "Release season",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": true
                        },
                        "attributes": [
                            {
                                "id": "RELEASE_SEASON",
                                "name": "Release season",
                                "value_type": "list",
                                "tags": [
                                    "hidden"
                                ],
                                "values": [
                                    {
                                        "id": "994283",
                                        "name": "Spring/Summer"
                                    }...
                                ],
                                "hierarchy": "FAMILY",
                                "relevance": 2
                            }
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "NUMBER_INPUT",
                        "label": "Release year",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": false
                        },
                        "attributes": [...],
                        "unified_units": []
                    },
                    {
                        "component": "COMBO",
                        "label": "Item condition",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": true
                        },
                        "attributes": [...],
                        "unified_units": []
                    },
                    {
                        "component": "TEXT_INPUT",
                        "label": "Filtrable size",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": false
                        },
                        "attributes": [
                            {
                                "id": "FILTRABLE_SIZE",
                                "name": "Filtrable size",
                                "value_type": "string",
                                "value_max_length": 255,
                                "tags": [
                                    "vip_hidden",
                                    "hidden",
                                    "read_only",
                                    "variation_attribute"
                                ],
                                "hierarchy": "ITEM",
                                "relevance": 2
                            }
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "TEXT_INPUT",
                        "label": "MPN",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": false
                        },
                        "attributes": [
                            {
                                "id": "MPN",
                                "name": "MPN",
                                "value_type": "string",
                                "value_max_length": 255,
                                "tags": [
                                    "vip_hidden",
                                    "hidden",
                                    "multivalued",
                                    "variation_attribute"
                                ],
                                "hierarchy": "PRODUCT_IDENTIFIER",
                                "relevance": 2
                            }
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "TEXT_INPUT",
                        "label": "SKU",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": false
                        },
                        "attributes": [
                            {
                                "id": "SELLER_SKU",
                                "name": "SKU",
                                "value_type": "string",
                                "value_max_length": 255,
                                "tags": [
                                    "vip_hidden",
                                    "hidden",
                                    "variation_attribute"
                                ],
                                "hierarchy": "ITEM",
                                "relevance": 1
                            }
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "BOOLEAN_INPUT",
                        "label": "Is",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": true
                        },
                        "attributes": [...],
                        "unified_units": []
                    },
                    {
                        "component": "BOOLEAN_INPUT",
                        "label": "Is",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": true
                        },
                        "attributes": [
                            {
                                "id": "IS_KIT",
                                "name": "Kit",
                                "value_type": "boolean",
                                "tags": [
                                    "hidden"
                                ],
                                "values": [
                                    {
                                        "id": "242084",
                                        "name": "No",
                                        "metadata": {
                                            "value": false
                                        }
                                    },
                                    {
                                        "id": "242085",
                                        "name": "Yes",
                                        "metadata": {
                                            "value": true
                                        }
                                    }
                                ],
                                "hierarchy": "ITEM",
                                "relevance": 2
                            }
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "TEXT_INPUT",
                        "label": "Descriptive tags",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": false
                        },
                        "attributes": [
                            {
                                "id": "DESCRIPTIVE_TAGS",
                                "name": "Descriptive tags",
                                "value_type": "string",
                                "value_max_length": 255,
                                "tags": [
                                    "vip_hidden",
                                    "hidden",
                                    "read_only",
                                    "multivalued"
                                ],
                                "hierarchy": "ITEM",
                                "relevance": 2
                            }
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "COMBO",
                        "label": "Product features",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": true
                        },
                        "attributes": [
                            {
                                "id": "PRODUCT_FEATURES",
                                "name": "Product features",
                                "value_type": "list",
                                "tags": [
                                    "vip_hidden",
                                    "hidden",
                                    "read_only",
                                    "multivalued"
                                ],
                                "values": [
                                    {
                                        "id": "7435885",
                                        "name": "Contains liquid"
                                    }...
                                ],
                                "hierarchy": "ITEM",
                                "relevance": 2
                            }
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "COMBO",
                        "label": "Product chemical features",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": true
                        },
                        "attributes": [...],
                                "hierarchy": "ITEM",
                                "relevance": 2
                            }
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "COMBO",
                        "label": "Foods and drinks",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": true
                        },
                        "attributes": [...],
                                "values": [
                                    {
                                        "id": "7575926",
                                        "name": "For humans"
                                    },
                                    {
                                        "id": "7575927",
                                        "name": "For animals"
                                    }
                                ],
                                "hierarchy": "ITEM",
                                "relevance": 2
                            }
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "COMBO",
                        "label": "Medicines",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": true
                        },
                        "attributes": [
                            {...}
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "COMBO",
                        "label": "Batteries features",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": true
                        },
                        "attributes": [
                            {
                                "id": "BATTERIES_FEATURES",
                                "name": "Batteries features",
                                "value_type": "list",
                                "tags": [...],
                                "values": [
                                    {
                                        "id": "7575934",
                                        "name": "Stand-alone lithium (loose or isolated)"
                                    },
                                    {
                                        "id": "7575935",
                                        "name": "Lithium installed"
                                    },
                                    {
                                        "id": "7575936",
                                        "name": "For cars (lead-acid)"
                                    }
                                ],
                                "hierarchy": "ITEM",
                                "relevance": 2
                            }
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "COMBO",
                        "label": "Shipment packing",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": true
                        },
                        "attributes": [
                            {
                                "id": "SHIPMENT_PACKING",
                                "name": "Shipment packing",
                                "value_type": "list",
                                "tags": [
                                    "vip_hidden",
                                    "hidden",
                                    "read_only",
                                    "multivalued"
                                ],
                                "values": [
                                    {
                                        "id": "7435891",
                                        "name": "Bag"
                                    },
                                    {
                                        "id": "7435892",
                                        "name": "Box"
                                    },
                                    {
                                        "id": "7575939",
                                        "name": "Self-shipping"
                                    }
                                ],
                                "hierarchy": "ITEM",
                                "relevance": 2
                            }
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "COMBO",
                        "label": "Additional info required",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": true
                        },
                        "attributes": [
                            {
                                "id": "ADDITIONAL_INFO_REQUIRED",
                                "name": "Additional info required",
                                "value_type": "list",
                                "tags": [
                                    "vip_hidden",
                                    "hidden",
                                    "read_only",
                                    "multivalued"
                                ],
                                "values": [
                                    {...}
                                ],
                                "hierarchy": "ITEM",
                                "relevance": 2
                            }
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "COMBO",
                        "label": "Exclusive channel",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": true
                        },
                        "attributes": [
                            {
                                "id": "EXCLUSIVE_CHANNEL",
                                "name": "Exclusive channel",
                                "value_type": "list",
                                "tags": [
                                    "vip_hidden",
                                    "hidden"
                                ],
                                "values": [...],
                                "hierarchy": "ITEM",
                                "relevance": 2
                            }
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "COMBO",
                        "label": "Excluded platforms",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": true
                        },
                        "attributes": [
                            {
                                "id": "EXCLUDED_PLATFORMS",
                                "name": "Excluded platforms",
                                "value_type": "list",
                                "tags": [
                                    "vip_hidden",
                                    "hidden",
                                    "read_only",
                                    "multivalued"
                                ],
                                "values": [...],
                                "hierarchy": "ITEM",
                                "relevance": 2
                            }
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "BOOLEAN_INPUT",
                        "label": "Is",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": true
                        },
                        "attributes": [
                            {
                                "id": "IS_SUITABLE_FOR_SHIPMENT",
                                "name": "Suitable for shipment",
                                "value_type": "boolean",
                                "tags": [
                                    "vip_hidden",
                                    "hidden",
                                    "read_only"
                                ],
                                "values": [
                                    {
                                        "id": "242084",
                                        "name": "No",
                                        "metadata": {
                                            "value": false
                                        }
                                    },
                                    {
                                        "id": "242085",
                                        "name": "Yes",
                                        "metadata": {
                                            "value": true
                                        }
                                    }
                                ],
                                "hierarchy": "ITEM",
                                "relevance": 2
                            }
                        ],
                        "unified_units": []
                    },
                    {
                        "component": "TEXT_INPUT",
                        "label": "Product data source",
                        "ui_config": {
                            "allow_custom_value": false,
                            "allow_filtering": false
                        },
                        "attributes": [
                            {
                                "id": "PRODUCT_DATA_SOURCE",
                                "name": "Product data source",
                                "value_type": "string",
                                "value_max_length": 255,
                                "tags": [
                                    "vip_hidden",
                                    "hidden"
                                ],
                                "hierarchy": "ITEM",
                                "relevance": 2
                            }
                        ],
                        "unified_units": []
                    }
                ]
            }
        ]
    },
    "output": {
        "main_title": "Características Principales",
        "groups": [
            {
                "id": "GENERAL_CHARACTERISTICS",
                "label": "Características generales",
                "relevance": 1,
                "section": "SPECIFICATIONS",
                "ui_config": {},
                "components": [
                    {
                        "component": "TEXT_OUTPUT",
                        "label": "Brand",
                        "ui_config": {
                            "hint": "Indicate the actual brand of the product or 'Generic' if it has no brand."
                        },
                        "attributes": [
                            {
                                "id": "BRAND",
                                "name": "Brand",
                                "value_type": "string",
                                "tags": [],
                                "hierarchy": "PARENT_PK",
                                "relevance": 1
                            }
                        ]
                    },
                    {
                        "component": "TEXT_OUTPUT",
                        "label": "Line",
                        "ui_config": {},
                        "attributes": [...]
                    },
                    {
                        "component": "TEXT_OUTPUT",
                        "label": "Alphanumeric model",
                        "ui_config": {},
                        "attributes": [
                            {
                                "id": "ALPHANUMERIC_MODEL",
                                "name": "Alphanumeric model",
                                "value_type": "string",
                                "tags": [],
                                "hierarchy": "PARENT_PK",
                                "relevance": 1
                            }
                        ]
                    },
                    {
                        "component": "COLOR_OUTPUT",
                        "label": "Color",
                        "ui_config": {
                            "connector": ""
                        },
                        "attributes": [
                            {
                                "id": "COLOR",
                                "name": "Color",
                                "value_type": "string",
                                "tags": [],
                                "hierarchy": "CHILD_PK",
                                "relevance": 1
                            }
                        ]
                    },
                    {
                        "component": "TEXT_OUTPUT",
                        "label": "Width type",
                        "ui_config": {},
                        "attributes": [
                            {
                                "id": "WIDTH_TYPE",
                                "name": "Width type",
                                "value_type": "string",
                                "tags": [],
                                "hierarchy": "CHILD_PK",
                                "relevance": 1
                            }
                        ]
                    },
                    {
                        "component": "TEXT_OUTPUT",
                        "label": "Detailed model",
                        "ui_config": {},
                        "attributes": [
                            {
                                "id": "DETAILED_MODEL",
                                "name": "Detailed model",
                                "value_type": "string",
                                "tags": [],
                                "hierarchy": "CHILD_DEPENDENT",
                                "relevance": 1
                            }
                        ]
                    }
                ]
            },
            {
                "id": "DESIGN",
                "label": "Diseño",
                "relevance": 1,
                "section": "SPECIFICATIONS",
                "ui_config": {},
                "components": [
                    {
                        "component": "TEXT_OUTPUT",
                        "label": "Fabric design",
                        "ui_config": {},
                        "attributes": [...]
                    },
                    {
                        "component": "BOOLEAN_OUTPUT",
                        "label": "With",
                        "ui_config": {},
                        "attributes": [
                            {
                                "id": "WITH_ANTI_SLIP_OUTSOLE",
                                "name": "Anti-slip outsole",
                                "value_type": "boolean",
                                "tags": [],
                                "hierarchy": "FAMILY",
                                "relevance": 2
                            }
                        ]
                    },
                    {
                        "component": "BOOLEAN_OUTPUT",
                        "label": "With",
                        "ui_config": {},
                        "attributes": [
                            {
                                "id": "WITH_PLATFORM",
                                "name": "Platform",
                                "value_type": "boolean",
                                "tags": [],
                                "hierarchy": "FAMILY",
                                "relevance": 2
                            }
                        ]
                    }...
                    {
                        "component": "BOOLEAN_OUTPUT",
                        "label": "With",
                        "ui_config": {},
                        "attributes": [
                            {
                                "id": "WITH_PADDED_COLLAR",
                                "name": "Padded collar",
                                "value_type": "boolean",
                                "tags": [],
                                "hierarchy": "FAMILY",
                                "relevance": 2
                            }
                        ]
                    }
                ]
            },
            {
                "id": "SIZE",
                "label": "Talle",
                "relevance": 1,
                "section": "SPECIFICATIONS",
                "ui_config": {},
                "components": [
                    {
                        "component": "TEXT_OUTPUT",
                        "label": "Size",
                        "ui_config": {},
                        "attributes": [
                            {
                                "id": "SIZE",
                                "name": "Size",
                                "value_type": "string",
                                "tags": [],
                                "hierarchy": "CHILD_PK",
                                "relevance": 1
                            }
                        ]
                    },
                    {
                        "component": "NUMBER_UNIT_OUTPUT",
                        "label": "Foot width",
                        "ui_config": {},
                        "attributes": [
                            {...}
                        ]
                    }
                ]
            },
            {
                "id": "SPECS",
                "label": "Especificaciones",
                "relevance": 1,
                "section": "SPECIFICATIONS",
                "ui_config": {},
                "components": [
                    {
                        "component": "TEXT_OUTPUT",
                        "label": "Style",
                        "ui_config": {},
                        "attributes": [
                            {
                                "id": "STYLE",
                                "name": "Style",
                                "value_type": "list",
                                "tags": [],
                                "hierarchy": "FAMILY",
                                "relevance": 1
                            }
                        ]
                    },
                    {
                        "component": "TEXT_OUTPUT",
                        "label": "Recommended sports",
                        "ui_config": {},
                        "attributes": [
                            {
                                "id": "RECOMMENDED_SPORTS",
                                "name": "Recommended sports",
                                "value_type": "string",
                                "tags": [],
                                "hierarchy": "FAMILY",
                                "relevance": 1
                            }
                        ]
                    },
                    {
                        "component": "TEXT_OUTPUT",
                        "label": "Footwear technologies",
                        "ui_config": {},
                        "attributes": [
                            {
                                "id": "FOOTWEAR_TECHNOLOGIES",
                                "name": "Footwear technologies",
                                "value_type": "string",
                                "tags": [],
                                "hierarchy": "FAMILY",
                                "relevance": 1
                            }
                        ]
                    }
                ]
            },
            {
                "id": "MATERIALS",
                "label": "Materiales",
                "relevance": 1,
                "section": "SPECIFICATIONS",
                "ui_config": {},
                "components": [...]
                    },
                    {
                        "component": "TEXT_OUTPUT",
                        "label": "Outsole materials",
                        "ui_config": {},
                        "attributes": [
                            {
                                "id": "OUTSOLE_MATERIALS",
                                "name": "Outsole materials",
                                "value_type": "string",
                                "tags": [],
                                "hierarchy": "FAMILY",
                                "relevance": 1
                            }
                        ]
                    }...
                    {
                        "component": "NUMBER_OUTPUT",
                        "label": "Release year",
                        "ui_config": {},
                        "attributes": [
                            {
                                "id": "RELEASE_YEAR",
                                "name": "Release year",
                                "value_type": "number",
                                "tags": [],
                                "hierarchy": "FAMILY",
                                "relevance": 2
                            }
                        ]
                    }
                ]
            },
            {
                "id": "OTHER",
                "label": "Otros",
                "relevance": 1,
                "section": "SPECIFICATIONS",
                "ui_config": {},
                "components": [...]
                    }
                    ...
                    {
                        "component": "BOOLEAN_OUTPUT",
                        "label": "Is",
                        "ui_config": {},
                        "attributes": [
                            {
                                "id": "IS_FLAMMABLE",
                                "name": "Flammable",
                                "value_type": "boolean",
                                "tags": [],
                                "hierarchy": "FAMILY",
                                "relevance": 2
                            }
                        ]
                    },
                    {...}
                        ]
                    }
                ]
            }
        ]
    }
}

Consulting a size charts data sheet

The size chart data sheet will determine the structure of the attributes with a measure table in the listing, you should execute a POST to the resource of /domains/$domain_id/technical_specs?section=grids and send all the attributes previously recognized with the grid_template_required tag.


Request:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d {...} https://api.mercadolibre.com/domains/$DOMAIN_ID/technical_specs/?section=grids

Example consulting the details of the technical data sheet for a specific size chart (personalized) and the female gender:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" https://api.mercadolibre.com/domains/CBT-SNEAKERS/technical_specs/?section=grids
{
    "attributes": [{
            "id": "SPECIFIC",
            "name": "Specific Chart",
            "value_id": "14671",
            "value_name": "",
            "value_struct": null,
            "values": [{
                "id": "14671",
                "name": "",
                "struct": null
            }],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Others"
        },
        {
            "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"
        }
    ]
}

Response with the detail of the technical data sheet of the size chart:

Note:
Consider this response for the JSON specification in the creation of the custom size chart.
{
   "input": {
       "groups": [
           {
               "id": "SIZE_CHART",
               "label": "Size chart",
               "relevance": 1,
               "section": "GRIDS",
               "ui_config": {},
               "components": [
                   {
                       "component": "GRID",
                       "label": "Size chart",
                       "ui_config": {
                           "max_allowed": 75,
                           "allow_custom_value": true,
                           "allow_filtering": false
                       },
                       "components": [
                           {
                               "component": "TEXT_OUTPUT",
                               "label": "Gender",
                               "ui_config": {},
                               "attributes": [
                                   {
                                       "id": "GENDER",
                                       "name": "Gender",
                                       "value_type": "string",
                                       "tags": [
                                           "grid_template_required",
                                           "grid_filter",
                                           "fixed",
                                           "catalog_required",
                                           "required"
                                       ],
                                       "values": [
                                           {
                                               "id": "339665",
                                               "name": "Woman"
                                           }
                                       ],
                                       "hierarchy": "PARENT_PK",
                                       "relevance": 1
                                   }
                               ],
                               "unified_units": []
                           },
                           {
                               "component": "TEXT_OUTPUT",
                               "label": "Brand",
                               "ui_config": {},
                               "attributes": [
                                   {
                                       "id": "BRAND",
                                       "name": "Brand",
                                       "value_type": "string",
                                       "value_max_length": 255,
                                       "tags": [
                                           "grid_filter",
                                           "catalog_required",
                                           "required"
                                       ],
                                       "hierarchy": "PARENT_PK",
                                       "relevance": 1
                                   }
                               ],
                               "unified_units": []
                           },
                           {
                               "component": "TEXT_INPUT",
                               "label": "Age",
                               "ui_config": {},
                               "attributes": [
                                   {
                                       "id": "AGE_GROUP",
                                       "name": "Age",
                                       "value_type": "string",
                                       "value_max_length": 255,
                                       "tags": [
                                           "hidden",
                                           "read_only",
                                           "grid_filter"
                                       ],
                                       "hierarchy": "PARENT_PK",
                                       "relevance": 1
                                   }
                               ],
                               "unified_units": []
                           },
                           {
                               "component": "TEXT_INPUT",
                               "label": "Style",
                               "ui_config": {},
                               "attributes": [
                                   {
                                       "id": "STYLE",
                                       "name": "Style",
                                       "value_type": "string",
                                       "value_max_length": 255,
                                       "tags": [
                                           "grid_filter",
                                           "required"
                                       ],
                                       "hierarchy": "FAMILY",
                                       "relevance": 1
                                   }
                               ],
                               "unified_units": []
                           },
                           {
                               "component": "TEXT_INPUT",
                               "label": "Recommended sports",
                               "ui_config": {},
                               "attributes": [
                                   {
                                       "id": "RECOMMENDED_SPORTS",
                                       "name": "Recommended sports",
                                       "value_type": "string",
                                       "value_max_length": 255,
                                       "tags": [
                                           "multivalued",
                                           "grid_filter"
                                       ],
                                       "hierarchy": "FAMILY",
                                       "relevance": 1
                                   }
                               ],
                               "unified_units": []
                           },
                           {
                               "component": "LINKED_BY_CONNECTOR_INPUT",
                               "label": "Foot length",
                               "ui_config": {
                                   "connector": " - ",
                                   "hint": "From - To"
                               },
                               "attributes": [
                                   {
                                       "id": "FOOT_LENGTH",
                                       "name": "Foot length",
                                       "value_type": "number_unit",
                                       "value_max_length": 255,
                                       "tags": [
                                           "required"
                                       ],
                                       "default_unit_id": "cm",
                                       "units": [
                                           {
                                               "id": "\"",
                                               "name": "\""
                                           },
                                           {
                                               "id": "cm",
                                               "name": "cm"
                                           }
                                       ],
                                       "hierarchy": "CHILD_DEPENDENT",
                                       "relevance": 3
                                   },
                                   {
                                       "id": "FOOT_LENGTH_TO",
                                       "name": "Foot length to",
                                       "value_type": "number_unit",
                                       "value_max_length": 255,
                                       "tags": [],
                                       "default_unit_id": "cm",
                                       "units": [
                                           {
                                               "id": "\"",
                                               "name": "\""
                                           },
                                           {
                                               "id": "cm",
                                               "name": "cm"
                                           }
                                       ],
                                       "hierarchy": "CHILD_DEPENDENT",
                                       "relevance": 3
                                   }
                               ],
                               "default_unified_unit_id": "cm",
                               "unified_units": [
                                   {
                                       "id": "\"",
                                       "name": "\""
                                   },
                                   {
                                       "id": "cm",
                                       "name": "cm"
                                   }
                               ]
                           },
                           {
                               "component": "TEXT_INPUT",
                               "label": "Manufacturer size",
                               "ui_config": {
                                   "allow_custom_value": false,
                                   "allow_filtering": false
                               },
                               "attributes": [
                                   {
                                       "id": "MANUFACTURER_SIZE",
                                       "name": "Manufacturer size",
                                       "value_type": "string",
                                       "value_max_length": 255,
                                       "tags": [
                                           "unique",
                                           "main_attribute_candidate"
                                       ],
                                       "hierarchy": "ITEM",
                                       "relevance": 1
                                   }
                               ],
                               "unified_units": []
                           },
                           {
                               "component": "NUMBER_UNIT_INPUT",
                               "label": "BR",
                               "ui_config": {
                                   "allow_custom_value": false,
                                   "allow_filtering": false
                               },
                               "attributes": [
                                   {
                                       "id": "BR_SIZE",
                                       "name": "BR",
                                       "value_type": "number_unit",
                                       "value_max_length": 255,
                                       "tags": [
                                           "main_attribute_candidate"
                                       ],
                                       "default_unit_id": "BR",
                                       "units": [
                                           {
                                               "id": "BR",
                                               "name": "BR"
                                           }
                                       ],
                                       "hierarchy": "CHILD_PK",
                                       "relevance": 1
                                   }
                               ],
                               "default_unified_unit_id": "BR",
                               "unified_units": [
                                   {
                                       "id": "BR",
                                       "name": "BR"
                                   }
                               ]
                           },
                           {
                               "component": "NUMBER_UNIT_INPUT",
                               "label": "MX",
                               "ui_config": {
                                   "allow_custom_value": false,
                                   "allow_filtering": false
                               },
                               "attributes": [
                                   {
                                       "id": "MX_SIZE",
                                       "name": "MX",
                                       "value_type": "number_unit",
                                       "value_max_length": 255,
                                       "tags": [
                                           "main_attribute_candidate"
                                       ],
                                       "default_unit_id": "MX",
                                       "units": [
                                           {
                                               "id": "MX",
                                               "name": "MX"
                                           }
                                       ],
                                       "hierarchy": "CHILD_PK",
                                       "relevance": 1
                                   }
                               ],
                               "default_unified_unit_id": "MX",
                               "unified_units": [
                                   {
                                       "id": "MX",
                                       "name": "MX"
                                   }
                               ]
                           },
                           {
                               "component": "NUMBER_UNIT_INPUT",
                               "label": "US-F",
                               "ui_config": {
                                   "allow_custom_value": false,
                                   "allow_filtering": false
                               },
                               "attributes": [
                                   {
                                       "id": "F_US_SIZE",
                                       "name": "US-F",
                                       "value_type": "number_unit",
                                       "value_max_length": 255,
                                       "tags": [
                                           "main_attribute_candidate"
                                       ],
                                       "default_unit_id": "US",
                                       "units": [
                                           {
                                               "id": "US",
                                               "name": "US"
                                           }
                                       ],
                                       "hierarchy": "CHILD_PK",
                                       "relevance": 1
                                   }
                               ],
                               "default_unified_unit_id": "US",
                               "unified_units": [
                                   {
                                       "id": "US",
                                       "name": "US"
                                   }
                               ]
                           },
                           {
                               "component": "NUMBER_UNIT_INPUT",
                               "label": "EU",
                               "ui_config": {
                                   "allow_custom_value": false,
                                   "allow_filtering": false
                               },
                               "attributes": [
                                   {
                                       "id": "EU_SIZE",
                                       "name": "EU",
                                       "value_type": "number_unit",
                                       "value_max_length": 255,
                                       "tags": [
                                           "main_attribute_candidate"
                                       ],
                                       "default_unit_id": "EU",
                                       "units": [
                                           {
                                               "id": "EU",
                                               "name": "EU"
                                           }
                                       ],
                                       "hierarchy": "CHILD_PK",
                                       "relevance": 1
                                   }
                               ],
                               "default_unified_unit_id": "EU",
                               "unified_units": [
                                   {
                                       "id": "EU",
                                       "name": "EU"
                                   }
                               ]
                           },
                           {
                               "component": "NUMBER_UNIT_INPUT",
                               "label": "UK",
                               "ui_config": {
                                   "allow_custom_value": false,
                                   "allow_filtering": false
                               },
                               "attributes": [
                                   {
                                       "id": "UK_SIZE",
                                       "name": "UK",
                                       "value_type": "number_unit",
                                       "value_max_length": 255,
                                       "tags": [
                                           "main_attribute_candidate"
                                       ],
                                       "default_unit_id": "UK",
                                       "units": [
                                           {
                                               "id": "UK",
                                               "name": "UK"
                                           }
                                       ],
                                       "hierarchy": "CHILD_PK",
                                       "relevance": 1
                                   }
                               ],
                               "default_unified_unit_id": "UK",
                               "unified_units": [
                                   {
                                       "id": "UK",
                                       "name": "UK"
                                   }
                               ]
                           }
                       ]
                   }
               ]
           }
       ]
   }
}

Available domains for size chart

See the domains activated with the size chart.


Request:

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

Response:

{
   "domains": [
       {
           "domain_id": "CBT-SNEAKERS"
       },
       {
           "domain_id": "CBT-BOOTS_AND_BOOTIES"
       },
       {
           "domain_id": "CBT-LOAFERS_AND_OXFORDS"
       },
       {
           "domain_id": "CBT-FOOTBALL_SHOES"
       },
       {
           "domain_id": "CBT-SANDALS_AND_CLOGS"
       },
       {
           "domain_id": "CBT-SNEAKERS_TEST"
       },
       {
           "domain_id": "CBT-PANTS_TEST"
       }
   ]
}

Validations and error messages

The requirement of the size chart is meant to validate if the information in the listing is consistent by using error messages, which we detail below.


In the validations of the requirement of a size chart for Live Listing, are not considered adjustments such as:
- Stock and price changes in the listing
- Paused or closed status changes in the listing
This means that, the error will not appear at the moment you make a PUT to the /items/ resource.


1. The SIZE_GRID_ID attribute does not exist in the listing:

{
    "code": "missing.fashion_grid.grid_id.values",
    "message": "Attribute [SIZE_GRID_ID] is missing",
    "type": "ERROR",
    "cause_id": 2610,
    "references": [
        "item.attributes"
    ],
    "department": "structured-data",
    "validation": "fashion-validator",
    "custom_data": {}
}

2. For the listing where there is the SIZE_GRID_ID attribute, but there is no attribute that specifies the row SIZE_GRID_ROW_ID:

{
    "code": "missing.fashion_grid.grid_row_id.values",
    "message": "Attribute [SIZE_GRID_ROW_ID] is missing",
    "type": "ERROR",
    "cause_id": 2611,
    "references": [
        "item.attributes"
    ],
    "department": "structured-data",
    "validation": "fashion-validator",
    "custom_data": {}
}

3. For the listing and/or its variations the attribute SIZE is not specified:

{
    "code": "missing.fashion_grid.size.values",
    "message": "Attribute [SIZE] is missing",
    "type": "ERROR",
    "cause_id": 2612,
    "references": [
        "item.attributes"
    ],
    "department": "structured-data",
    "validation": "fashion-validator",
    "custom_data": {}
}

4. The listing with the SIZE_GRID_ID attribute specification, but the table code sent is invalid, for example when the listing associates a size chart of another category:

{
    "code": "invalid.fashion_grid.grid_id.values",
    "message": "Attribute [SIZE_GRID_ID] is not valid",
    "type": "ERROR",
    "cause_id": 2613,
    "references": [
        "item.name"
    ],
    "department": "structured-data",
    "validation": "fashion-validator",
    "custom_data": {}
}

5. The listing has the attribute specification SIZE_GRID_ID and SIZE_GRID_ROW_ID but the id sent in row is invalid, it does not exist in the table specified in grid_id:

{
    "code": "invalid.fashion_grid.grid_row_id.values",
    "message": "Attribute [SIZE_GRID_ROW_ID] is not valid",
    "type": "ERROR",
    "cause_id": 2614,
    "references": [
        "item.name"
    ],
    "department": "structured-data",
    "validation": "fashion-validator",
    "custom_data": {}
}

6. The size attribute of the listing or variation must consistently match the row in the table you are selecting; they must be identical if the SIZE of the listing or variation is invalid in this comparison:

{
    "code": "invalid.fashion_grid.size.values",
    "message": "Attribute [SIZE] is not valid",
    "type": "WARNING",
    "cause_id": 2615,
    "references": [
        "item.name"
    ],
    "department": "structured-data",
    "validation": "fashion-validator",
    "custom_data": {}
}

7. The attributes detailed in the table must correspond consistently with the information in the listing, for example, the GENDER attribute in the table must be the same as the one in the listing:

{
    "code": "invalid.fashion_grid.size.values",
    "message": "Attribute [GENDER] is not valid",
    "type": "WARNING",
    "cause_id": 2616,
    "references": [
        "item.name"
    ],
    "department": "structured-data",
    "validation": "fashion-validator",
    "custom_data": {}
}