Attributes

Contents

→What is an attribute?
→Types of possible attributes
    ↳string
    ↳number
    ↳number_unit
    ↳boolean
    ↳list
→Special behaviors
→Mandatory attributes
    ↳How to identify penalized items
→Specify not applicable attributes
→Create ítem with atribute N/A
→Change an active post and indicate an attribute is not applicable (N/A)
    ↳Considerations
→Exclusions and implications of behaviors
→Benefit
→Create an item with attributes N/A
→Change and/or add attributes (N/A)
→Delete attributes

What is an attribute?

An attribute represents a characteristic of your item, such as Microwave Oven Brand and Model. You can add them when listing an item, and you can change them or add new ones later. Take into account that attributes vary by category, and you can find them at the following request.

Request:

curl -X GET https://api.mercadolibre.com/categories/$CATEGORY_ID/attributes

Example:

curl -X GET https://api.mercadolibre.com/categories/CBT391873/attributes

Response:

[
  {
    "id": "BRAND",
    "name": "Brand",
    "tags": {
      "catalog_required": true
    },
    "hierarchy": "PARENT_PK",
    "relevance": 1,
    "value_type": "string",
    "value_max_length": 255,
    "values": [
      {
        "id": "498493",
        "name": "47 Street"
      },
      {
        "id": "2787048",
        "name": "Alliance"
      },
      {
        "id": "56202",
        "name": "Ana Hickmann"
      },
      {
        "id": "350205",
        "name": "Axis"
      },
      {
        "id": "1157003",
        "name": "Barbie"
      },
      {
        "id": "23688",
        "name": "Benetton"
      },
      {
        "id": "428830",
        "name": "Blaquè"
      },
      {
        "id": "2787047",
        "name": "Cabotine"
      },
      {
        "id": "2787050",
        "name": "Ciel"
      },
      {
        "id": "33243",
        "name": "Disney"
      },
      {
        "id": "433272",
        "name": "Ed Hardy"
      },
      {
        "id": "1229482",
        "name": "Eyelit"
      },
      {
        "id": "428690",
        "name": "Hot Wheels"
      },
      {
        "id": "2786085",
        "name": "Kevingston"
      },
      {
        "id": "2786711",
        "name": "Monster High"
      },
      {
        "id": "498496",
        "name": "Muaa"
      },
      {
        "id": "2787049",
        "name": "Petit"
      },
      {
        "id": "2786636",
        "name": "Portsaid"
      },
      {
        "id": "240356",
        "name": "Prototype"
      },
      {
        "id": "2787044",
        "name": "Samba"
      },
      {
        "id": "428844",
        "name": "Stone"
      },
      {
        "id": "2427441",
        "name": "Valeria Mazza"
      },
      {
        "id": "2705514",
        "name": "Violetta"
      },
      {
        "id": "1162047",
        "name": "Yves Rocher"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "LINE",
    "name": "Line",
    "tags": {
      "hidden": true
    },
    "hierarchy": "PARENT_PK",
    "relevance": 1,
    "value_type": "string",
    "value_max_length": 255,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "PERFUME_NAME",
    "name": "Name",
    "tags": {
    },
    "hierarchy": "PARENT_PK",
    "relevance": 1,
    "value_type": "string",
    "value_max_length": 255,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "VERSION",
    "name": "Version",
    "tags": {
      "hidden": true
    },
    "hierarchy": "PARENT_PK",
    "relevance": 1,
    "value_type": "string",
    "value_max_length": 255,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "GENDER",
    "name": "Gender",
    "tags": {
    },
    "hierarchy": "PARENT_PK",
    "relevance": 1,
    "value_type": "list",
    "values": [
      {
        "id": "110461",
        "name": "Gender neutral"
      },
      {
        "id": "339665",
        "name": "Female"
      },
      {
        "id": "339666",
        "name": "Male"
      },
      {
        "id": "339667",
        "name": "Boys"
      },
      {
        "id": "339668",
        "name": "Girls"
      },
      {
        "id": "371795",
        "name": "Babies"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "PERFUME_TYPE",
    "name": "Type",
    "tags": {
      "fixed": true
    },
    "hierarchy": "PARENT_PK",
    "relevance": 1,
    "value_type": "string",
    "value_max_length": 255,
    "values": [
      {
        "id": "188085",
        "name": "Body splash"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "UNIT_VOLUME",
    "name": "Unit volume",
    "tags": {
    },
    "hierarchy": "CHILD_PK",
    "relevance": 1,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "mL",
        "name": "mL"
      }
    ],
    "default_unit": "mL",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "SET_PIECES",
    "name": "Set pieces",
    "tags": {
      "multivalued": true
    },
    "hierarchy": "CHILD_DEPENDENT",
    "relevance": 1,
    "value_type": "string",
    "value_max_length": 255,
    "values": [
      {
        "id": "2215606",
        "name": "Body lotion"
      },
      {
        "id": "2215605",
        "name": "Shower gel"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "AGE_GROUP",
    "name": "Age",
    "tags": {
    },
    "hierarchy": "FAMILY",
    "relevance": 1,
    "value_type": "list",
    "values": [
      {
        "id": "1065183",
        "name": "Kids"
      },
      {
        "id": "1065182",
        "name": "Adults"
      },
      {
        "id": "371795",
        "name": "Babies"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "UNITS_PER_PACKAGE",
    "name": "Units per package",
    "tags": {
    },
    "hierarchy": "ITEM",
    "relevance": 1,
    "value_type": "number",
    "value_max_length": 18,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "QUANTITY",
    "name": "Quantity",
    "tags": {
    },
    "hierarchy": "ITEM",
    "relevance": 1,
    "value_type": "number",
    "value_max_length": 18,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "UNIT_TYPE",
    "name": "Unit type",
    "tags": {
    },
    "hierarchy": "ITEM",
    "relevance": 1,
    "value_type": "list",
    "values": [
      {
        "id": "6937304",
        "name": "L"
      },
      {
        "id": "7350718",
        "name": "mL"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "GTIN",
    "name": "Universal product code",
    "tags": {
      "multivalued": true,
      "variation_attribute": true,
      "used_hidden": true,
      "validate": true
    },
    "hierarchy": "PRODUCT_IDENTIFIER",
    "relevance": 1,
    "type": "product_identifier",
    "value_type": "string",
    "value_max_length": 255,
    "tooltip": "How do I recognize it? It is an 8 to 14 digit number next to the barcode, on the product box or on its label. ![Universal product code](https://http2.mlstatic.com/static/org-img/sd-landings/assets/pi-tooltip.png)",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others",
    "hint": "It may be an EAN, UPC or another GTIN."
  },
  {
    "id": "RELEASE_YEAR",
    "name": "Release year",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "number",
    "value_max_length": 18,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "UPC",
    "name": "UPC",
    "tags": {
      "hidden": true,
      "multivalued": true,
      "variation_attribute": true,
      "validate": true
    },
    "hierarchy": "PRODUCT_IDENTIFIER",
    "relevance": 2,
    "type": "product_identifier",
    "value_type": "string",
    "value_max_length": 255,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "MPN",
    "name": "MPN",
    "tags": {
      "hidden": true,
      "multivalued": true,
      "variation_attribute": true
    },
    "hierarchy": "PRODUCT_IDENTIFIER",
    "relevance": 2,
    "type": "product_identifier",
    "value_type": "string",
    "value_max_length": 255,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "EAN",
    "name": "EAN",
    "tags": {
      "hidden": true,
      "multivalued": true,
      "variation_attribute": true,
      "validate": true
    },
    "hierarchy": "PRODUCT_IDENTIFIER",
    "relevance": 2,
    "type": "product_identifier",
    "value_type": "string",
    "value_max_length": 255,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "ORIGIN",
    "name": "Origin",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "string",
    "value_max_length": 255,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "ITEM_CONDITION",
    "name": "Item condition",
    "tags": {
      "hidden": true
    },
    "hierarchy": "ITEM",
    "relevance": 2,
    "value_type": "list",
    "values": [
      {
        "id": "2230284",
        "name": "New"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "MODEL",
    "name": "Model",
    "tags": {
      "hidden": true
    },
    "hierarchy": "PARENT_PK",
    "relevance": 1,
    "value_type": "string",
    "value_max_length": 255,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "SELLER_SKU",
    "name": "SKU",
    "tags": {
      "hidden": true,
      "variation_attribute": true
    },
    "hierarchy": "ITEM",
    "relevance": 1,
    "value_type": "string",
    "value_max_length": 255,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "IS_FLAMMABLE",
    "name": "Is flammable",
    "tags": {
      "hidden": true,
      "read_only": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "boolean",
    "values": [
      {
        "id": "242084",
        "name": "No",
        "metadata": {
          "value": false
        }
      },
      {
        "id": "242085",
        "name": "Yes",
        "metadata": {
          "value": true
        }
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "IS_KIT",
    "name": "Is kit",
    "tags": {
      "hidden": true
    },
    "hierarchy": "ITEM",
    "relevance": 2,
    "value_type": "boolean",
    "values": [
      {
        "id": "242084",
        "name": "No",
        "metadata": {
          "value": false
        }
      },
      {
        "id": "242085",
        "name": "Yes",
        "metadata": {
          "value": true
        }
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "DESCRIPTIVE_TAGS",
    "name": "Descriptive tags",
    "tags": {
      "hidden": true,
      "multivalued": true,
      "read_only": true
    },
    "hierarchy": "ITEM",
    "relevance": 2,
    "value_type": "string",
    "value_max_length": 255,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "PACKAGE_LENGTH",
    "name": "Package length",
    "tags": {
      "hidden": true,
      "variation_attribute": true
    },
    "hierarchy": "ITEM",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "km",
        "name": "km"
      },
      {
        "id": "ft",
        "name": "ft"
      },
      {
        "id": "pulgadas",
        "name": "pulgadas"
      },
      {
        "id": "m",
        "name": "m"
      },
      {
        "id": "mm",
        "name": "mm"
      },
      {
        "id": "µm",
        "name": "µm"
      },
      {
        "id": "hh",
        "name": "hh"
      },
      {
        "id": "U",
        "name": "U"
      },
      {
        "id": "nm",
        "name": "nm"
      },
      {
        "id": "in",
        "name": "in"
      },
      {
        "id": """,
        "name": """
      },
      {
        "id": "cm",
        "name": "cm"
      },
      {
        "id": "yd",
        "name": "yd"
      }
    ],
    "default_unit": "cm",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "PACKAGE_WEIGHT",
    "name": "Package weight",
    "tags": {
      "hidden": true,
      "variation_attribute": true
    },
    "hierarchy": "ITEM",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "mcg",
        "name": "mcg"
      },
      {
        "id": "oz",
        "name": "oz"
      },
      {
        "id": "g",
        "name": "g"
      },
      {
        "id": "t",
        "name": "t"
      },
      {
        "id": "kg",
        "name": "kg"
      },
      {
        "id": "mg",
        "name": "mg"
      },
      {
        "id": "lb",
        "name": "lb"
      }
    ],
    "default_unit": "g",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "PACKAGE_WIDTH",
    "name": "Package width",
    "tags": {
      "hidden": true,
      "variation_attribute": true
    },
    "hierarchy": "ITEM",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "km",
        "name": "km"
      },
      {
        "id": "ft",
        "name": "ft"
      },
      {
        "id": "pulgadas",
        "name": "pulgadas"
      },
      {
        "id": "m",
        "name": "m"
      },
      {
        "id": "mm",
        "name": "mm"
      },
      {
        "id": "µm",
        "name": "µm"
      },
      {
        "id": "hh",
        "name": "hh"
      },
      {
        "id": "U",
        "name": "U"
      },
      {
        "id": "nm",
        "name": "nm"
      },
      {
        "id": "in",
        "name": "in"
      },
      {
        "id": """,
        "name": """
      },
      {
        "id": "cm",
        "name": "cm"
      },
      {
        "id": "yd",
        "name": "yd"
      }
    ],
    "default_unit": "cm",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "PACKAGE_HEIGHT",
    "name": "Package height",
    "tags": {
      "hidden": true,
      "variation_attribute": true
    },
    "hierarchy": "ITEM",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "km",
        "name": "km"
      },
      {
        "id": "ft",
        "name": "ft"
      },
      {
        "id": "pulgadas",
        "name": "pulgadas"
      },
      {
        "id": "m",
        "name": "m"
      },
      {
        "id": "mm",
        "name": "mm"
      },
      {
        "id": "µm",
        "name": "µm"
      },
      {
        "id": "hh",
        "name": "hh"
      },
      {
        "id": "U",
        "name": "U"
      },
      {
        "id": "nm",
        "name": "nm"
      },
      {
        "id": "in",
        "name": "in"
      },
      {
        "id": """,
        "name": """
      },
      {
        "id": "cm",
        "name": "cm"
      },
      {
        "id": "yd",
        "name": "yd"
      }
    ],
    "default_unit": "cm",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "PRODUCT_FEATURES",
    "name": "Product features",
    "tags": {
      "hidden": true,
      "multivalued": true,
      "read_only": true
    },
    "hierarchy": "ITEM",
    "relevance": 2,
    "value_type": "list",
    "values": [
      {
        "id": "7435885",
        "name": "Contains liquid"
      },
      {
        "id": "7435883",
        "name": "Fragile"
      },
      {
        "id": "7435888",
        "name": "With expiration"
      },
      {
        "id": "7575917",
        "name": "Disinfectant and sanitizer"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "PRODUCT_CHEMICAL_FEATURES",
    "name": "Product chemical features",
    "tags": {
      "hidden": true,
      "multivalued": true,
      "read_only": true
    },
    "hierarchy": "ITEM",
    "relevance": 2,
    "value_type": "list",
    "values": [
      {
        "id": "7651070",
        "name": "Flammable"
      },
      {
        "id": "7651071",
        "name": "Aerosol"
      },
      {
        "id": "7651072",
        "name": "Oxidizer"
      },
      {
        "id": "7651073",
        "name": "Corrosive"
      },
      {
        "id": "7651074",
        "name": "Explosive"
      },
      {
        "id": "7651075",
        "name": "Toxic or infectious"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "FOODS_AND_DRINKS",
    "name": "Foods and drinks",
    "tags": {
      "hidden": true,
      "multivalued": true,
      "read_only": true
    },
    "hierarchy": "ITEM",
    "relevance": 2,
    "value_type": "list",
    "values": [
      {
        "id": "7575926",
        "name": "For humans"
      },
      {
        "id": "7575927",
        "name": "For animals"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "MEDICINES",
    "name": "Medicines",
    "tags": {
      "hidden": true,
      "multivalued": true,
      "read_only": true
    },
    "hierarchy": "ITEM",
    "relevance": 2,
    "value_type": "list",
    "values": [
      {
        "id": "7575930",
        "name": "For humans with a medical prescription"
      },
      {
        "id": "7575931",
        "name": "For humans without a medical prescription"
      },
      {
        "id": "7575932",
        "name": "For animals with a medical prescription"
      },
      {
        "id": "7575933",
        "name": "For animals without a medical prescription"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "BATTERIES_FEATURES",
    "name": "Batteries features",
    "tags": {
      "hidden": true,
      "multivalued": true,
      "read_only": true
    },
    "hierarchy": "ITEM",
    "relevance": 2,
    "value_type": "list",
    "values": [
      {
        "id": "7575934",
        "name": "Stand-alone lithium (loose or isolated)"
      },
      {
        "id": "7575935",
        "name": "Lithium installed"
      },
      {
        "id": "7575936",
        "name": "For cars (lead-acid)"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "SHIPMENT_PACKING",
    "name": "Shipment packing",
    "tags": {
      "hidden": true,
      "multivalued": true,
      "read_only": true
    },
    "hierarchy": "ITEM",
    "relevance": 2,
    "value_type": "list",
    "values": [
      {
        "id": "7435891",
        "name": "Bag"
      },
      {
        "id": "7435892",
        "name": "Box"
      },
      {
        "id": "7575937",
        "name": "Envelope"
      },
      {
        "id": "7575938",
        "name": "Voluminous"
      },
      {
        "id": "7575939",
        "name": "Self-shipping"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "ADDITIONAL_INFO_REQUIRED",
    "name": "Additional info required",
    "tags": {
      "hidden": true,
      "multivalued": true,
      "read_only": true
    },
    "hierarchy": "ITEM",
    "relevance": 2,
    "value_type": "list",
    "values": [
      {
        "id": "7435893",
        "name": "Has IMEI"
      },
      {
        "id": "7435894",
        "name": "Has serial number"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "EXCLUSIVE_CHANNEL",
    "name": "Exclusive channel",
    "tags": {
      "hidden": true
    },
    "hierarchy": "ITEM",
    "relevance": 2,
    "value_type": "list",
    "values": [
      {
        "id": "7865258",
        "name": "Mercado Shops"
      },
      {
        "id": "7865259",
        "name": "Mercado Libre"
      },
      {
        "id": "7889418",
        "name": "Private"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "IS_SUITABLE_FOR_SHIPMENT",
    "name": "Is suitable for shipment",
    "tags": {
      "hidden": true,
      "read_only": true
    },
    "hierarchy": "ITEM",
    "relevance": 2,
    "value_type": "boolean",
    "values": [
      {
        "id": "242084",
        "name": "No",
        "metadata": {
          "value": false
        }
      },
      {
        "id": "242085",
        "name": "Yes",
        "metadata": {
          "value": true
        }
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  }
]

Types of possible attributes

There are different types of attributes, so the values to be supported will depend on them. Types of attributes can be viewed by entering the attribute API of the relevant category and querying the value_type field. The possible types are:


string

You can complete this type of attributes with free text, including letters and numbers indistinctively.

Considerations: for this attributes, there is a list of suggested values, but you can also enter new ones which are not included in such list. For new values, you should only send us the name, but for known values, you can send us the id as the name. We encourage you to see the suggested values in the API!


number

These attributes can be only completed with numeric values.

Considerations: for this type of attributes there is a list of suggested values, but you can also enter new ones that are not included in that list. For new values, you should only send us the name, but for known values, you can send us the id as well as the name. We encourage you to see the suggested values in the API!


number_unit

Attributes made up of a numeric value and a unit. You can view the units available for such attributes in the attribute API.

Notes:
- He format of these attributes will be validated when making or changing a listing, that is, checking that the above described format is followed.
- For all the above types of attributes, the value_max_length field shows the maximum number of characters to be uploaded in attribute value.

boolean

It only allows for two values: one corresponding to a positive value and the other corresponding to a negative one.

Considerations: you should send the value id, which you can query in the attribute API.


list

The values property lists the possible values that this attribute may take, there should always be at least one.
Considerations: if you wish to enter a value that is not in the list, you can do so by sending your custom value in value_name with the value_id that is closest to yours. For example, if you are selling a mobile Air Conditioner but the attribute PRODUCT_TYPE does not have a value that exactly represents your item, you can use the value_id of the value Portable but in the value_name send Mobile.


Special behaviors

The tags property specifies particular attribute behaviors. Find below a list of the possible values that may be included, along with a behavior description.

  • allow_variations:It allows the item to vary by attribute. For this reason, you should check that the allow_variations tag is set in “true” in order to upload the variations. To learn more about how to add them, please read the documentation about Variations.
  • defines_picture:it shows that the attribute defines the picture. For example, Color for shoes.The use of this tag will show how to display the different components in the flows. Take into account that this behavior only applies to attributes that allow for variations.
  • fixed:it shows that there is a fixed value for the category and that all the items listed under this section should have such value. For example, if you are selling a Microwave Oven in the category MLB232411 corresponding to Microwave Ovens -> Other Brands -> 18 Litres, such category includes the VOLUMEN_CAPACITY attribute with values 18 Litres, 20 Litres, etc. but for such category we already know that the appropriate value is 18 Litres. So you do not need to send it when listing because we autocomplete it for you.
  • hidden: attributes with this property are not shown in the sell flow, but they can be uploaded via the API.
  • inferred:it shows that there is an inferred value for the attribute. That value cannot be modified. For example, in the category of iPhone under cell phones, the attribute LINE is fixed with the value iPhone, and it is inferred that the brand is Apple.
  • multivalued:attributes can be completed with more than one value, separated by commas.
  • others: this tag is for internal use.
  • product_pk: this tag helps identify the attributes that are part of the pk of a product. From it, we can uniquely identify a product from the catalogue.
  • read_only: this tag is for internal use. Attributes with this tag cannot be uploaded or changed by the sellers.
  • required: to list the item, the attribute should be completed.
  • restricted_values: this tag is for internal use.
  • variation_attribute: if the item allows for variations, this attribute can be listed with a different value for each variation. For example, in any electronics listing with variations by color, product identifier codes can be uploaded for each variation. A value for this attribute can also be uploaded if the item does not have any variation.

Mandatory attributes

Querying the resource /categories/$CATEGORY_ID/technical_specs/input you can find out which are the mandatory attributes by category and complete them in advance to avoid the publications to be affected in their ranking in search results. You can identify the mandatory attributes mandatory with the tag “required”.
Request:

curl -X GET https://api.mercadolibre.com/categories/$CATEGORY_ID/technical_specs/input

Example:

curl -X GET https://api.mercadolibre.com/categories/CBT1055/technical_specs/input

Response:

{
   "groups":[
      {
         "id":"MAIN",
         "label":"Características principales",
         "relevance":1,
         "ui_config":{

         },
         "components":[
            {
               "component":"TEXT_INPUT",
               "label":"Brand",
               "ui_config":{

               },
               "attributes":[
                  {
                     "id":"BRAND",
                     "name":"Brand",
                     "value_type":"string",
                     "value_max_length":255,
                     "tags":[
                        "catalog_required",
                        "required"
                     ],
                     "hierarchy":"PARENT_PK",
                     "relevance":1
                  }
               ],
               "unified_units":[

               ]
            },
            {

            },
            {

            },
            {

            },
            {

            },
            {

            },
            {

            },
            {

            }
         ]
      },
      {

      }
   ]
}
Notes:
- The attributes marked as required in the resource /categories/$CATEGORY_ID/attributes are mandatory when listing, if they are not present an error will be generated.
- The attributes marked as mandatory in this new resource and that are not present in /categories/$CATEGORY_ID/attributes, will only affect the ranking on search results. Take into account that to identify the items that are losing their rank, you should check the incomplete_technical_specs tag.

With the resource /categories/$CATEGORY_ID/technical_specs/output you can show your products as they are displayed in Mercado Libre, this way, your listings will be organized with the same data sheet.


How to identify penalized items

With the resource items/search? you can list, in the field “results”, all the penalized items that have the incomplete_technical_specs tag. This way, you will identify the publications that are losing rank in the search results to improve their quality. To find out in detail the reasons why your publications are losing rank, you should check the quality resources.


Specify not applicable attributes

If any specification does not apply to the product you are posting, it is important to mark it as N/A (Not Applicable). To that end, you should send:

  • Value_id = “-1”
  • Value_name = Null

In the items API, in order to display the attributes N/A the parameter include_internal_attributes=true must be added, since if the request is made without it, the attributes N/A will not be displayed.

Request:

curl -X GET https://api.mercadolibre.com/items/$ITEM_ID?attributes=attributes&include_internal_attributes=true

Example:

curl -X GET http://api.mercadolibre.com/items/CBT926430395?attributes=attributes&include_internal_attributes=true

Response:

{
  "attributes": [
    {
      "value_id": "517584",
      "value_name": "Shoe",
      "value_struct": null,
      "values": [
        {
          "id": "517584",
          "name": "Shoe",
          "struct": null
        }
      ],
      "attribute_group_id": "OTHERS",
      "attribute_group_name": "Others",
      "id": "FOOTWEAR_TYPE",
      "name": "Footwear type"
    },
    {
      "attribute_group_name": "Others",
      "id": "GENDER",
      "name": "Gender",
      "value_id": "371795",
      "value_name": "Babies",
      "value_struct": null,
      "values": [
        {
          "id": "371795",
          "name": "Babies",
          "struct": null
        }
      ],
      "attribute_group_id": "OTHERS"
    },
    {
      "value_struct": null,
      "values": [
        {
          "id": null,
          "name": "No Brand",
          "struct": null
        }
      ],
      "attribute_group_id": "OTHERS",
      "attribute_group_name": "Others",
      "id": "MODEL",
      "name": "Model",
      "value_id": null,
      "value_name": "No Brand"
    }
  ]
}

 

Create ítem with atribute N/A

curl -X PUT http://api.mercadolibre.com/items/CBT926679282?access_token=$ACCESS_TOKEN
  -d '{
    "attributes": [
        {
            "id": "BRAND",
            "name": "Brand",
            "value_name": "DOMINIQ"
        },
        {
            "id": "FOOTWEAR_TYPE",
            "value_id": "517583",
            "value_name": "Sneaker"
        },
        {
            "value_name": "Babies",
            "id": "GENDER",
            "value_id": "371795"
        },
        {
            "value_id": "2230284",
            "value_name": "New",
            "id": "ITEM_CONDITION"
        },
        {
            "value_name": "A-59081-6",
            "value_struct": null,
            "id": "MODEL"
        },
        {
            "id": "PACKAGE_HEIGHT",
            "name": "Package height",
            "value_name": "10 cm"
        },
        {
            "value_name": "10 cm",
            "id": "PACKAGE_LENGTH"
        },
        {
            "id": "PACKAGE_WEIGHT",
            "value_name": "0.7 lb"
        },
        {
            "name": "Package width",
            "value_name": "10 cm",
            "id": "PACKAGE_WIDTH"
        },
        {
            "name": "COLOR",
            "value_id": "52019"
        }
    ]
}'

Change an active post and indicate an attribute is not applicable (N/A)

curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d {	"attributes": [{
			"id": "COLOR",
			"value_id": "52049"
		},
		{
			"id": "VOLTAGE",
			"value_name": "198813"
		},
		{
			"id": "DIAMETER",
			"value_id": “-1”,
			"value_name": null
		},
		{
			"id": "LATERAL_OSCILLATION",
			"value_id": "242085"
		
		}
	]
}

Considerations

  • Attributes with allow_variations tag cannot be N/A.
  • If a value_id -1 attribute is sent, but the value_name has a value other than null, it will be disregarded as if it has never been sent. This is because, from the item API, it is verified whether the N/A specification has been sent, and both fields are read to consider an N/A attribute.
  • So far, if you send N/A, it can only be replaced for a value (When making a PUT, the attribute cannot be null).

Exclusions and implications of behaviors

Matrix of exclusions            
  Required Fixed Allow_variations Variation_attribute Defines_Picture Hidden
Required           X
Fixed     X X X  
Allow_variations   X   X    
Variation_attribute   X X   X  
Defines_Picture   X   X    
Hidden X          

Matrix of exclusions            
  Required Fixed Allow_variations Variation_attribute Defines_Picture Hidden
Required            
Fixed            
Allow_variations            
Variation_attribute            
Defines_Picture     X      
Hidden            

Benefit

Item information will be more comprehensive and relevant, with attributes displayed in a VIP data sheet to avoid questions and friction.


Create an item with attributes

Imagine that you want to sell a Microwave Oven about which you know brand, model, and capacity. First, you should select the category in which you want to list it and, then, you should query the attributes for such category:

Request:

curl -X GET https://api.mercadolibre.com/categories/$CATEGORY_ID/attributes

Example:

curl -X GET https://api.mercadolibre.com/categories/CBT11796/attributes

Response:

[
  {
    "id": "BRAND",
    "name": "Brand",
    "tags": {
      "catalog_required": true
    },
    "hierarchy": "PARENT_PK",
    "relevance": 1,
    "value_type": "string",
    "value_max_length": 255,
    "values": [
      {
        "id": "515916",
        "name": "Addnice"
      },
      {
        "id": "14810",
        "name": "Adidas"
      },
      {
        "id": "515915",
        "name": "Atomik"
      },
      {
        "id": "7143714",
        "name": "Carter's"
      },
      {
        "id": "515911",
        "name": "Cheeky"
      },
      {
        "id": "433277",
        "name": "Grisino"
      },
      {
        "id": "515914",
        "name": "Little Akiabara"
      },
      {
        "id": "515909",
        "name": "Mimo & Co"
      },
      {
        "id": "415948",
        "name": "Topper"
      },
      {
        "id": "515913",
        "name": "Tropicana"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "MODEL",
    "name": "Model",
    "tags": {
      "catalog_required": true
    },
    "hierarchy": "PARENT_PK",
    "relevance": 1,
    "value_type": "string",
    "value_max_length": 255,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "COLOR",
    "name": "Color",
    "tags": {
      "allow_variations": true,
      "defines_picture": true
    },
    "hierarchy": "CHILD_PK",
    "relevance": 1,
    "value_type": "string",
    "value_max_length": 255,
    "values": [
      {
        "id": "52019",
        "name": "Dark green"
      },
      {
        "id": "283160",
        "name": "Turquoise"
      },
      {
        "id": "52022",
        "name": "Water"
      },
      {
        "id": "283162",
        "name": "Indigo"
      },
      {
        "id": "52036",
        "name": "Lavender"
      },
      {
        "id": "283163",
        "name": "Pink gum"
      },
      {
        "id": "51998",
        "name": "Maroon"
      },
      {
        "id": "52003",
        "name": "Fur"
      },
      {
        "id": "52055",
        "name": "Blank"
      },
      {
        "id": "283161",
        "name": "Navy blue"
      },
      {
        "id": "52008",
        "name": "Cream"
      },
      {
        "id": "52045",
        "name": "Pale pink"
      },
      {
        "id": "283153",
        "name": "Cleat"
      },
      {
        "id": "283150",
        "name": "Light orange"
      },
      {
        "id": "52028",
        "name": "Blue"
      },
      {
        "id": "52043",
        "name": "Light pink"
      },
      {
        "id": "283148",
        "name": "Light coral"
      },
      {
        "id": "283149",
        "name": "Coral"
      },
      {
        "id": "52021",
        "name": "Heavenly"
      },
      {
        "id": "52031",
        "name": "Blue steel"
      },
      {
        "id": "283156",
        "name": "Khaki"
      },
      {
        "id": "52001",
        "name": "Beige"
      },
      {
        "id": "51993",
        "name": "Red"
      },
      {
        "id": "51996",
        "name": "Terracotta"
      },
      {
        "id": "283165",
        "name": "Grey"
      },
      {
        "id": "52035",
        "name": "Violet"
      },
      {
        "id": "283154",
        "name": "Light brown"
      },
      {
        "id": "52049",
        "name": "Black"
      },
      {
        "id": "283155",
        "name": "Dark brown"
      },
      {
        "id": "52053",
        "name": "Silver"
      },
      {
        "id": "52047",
        "name": "Dark violet"
      },
      {
        "id": "51994",
        "name": "Pink"
      },
      {
        "id": "52007",
        "name": "Yellow"
      },
      {
        "id": "283157",
        "name": "Lime green"
      },
      {
        "id": "52012",
        "name": "Dark gold"
      },
      {
        "id": "52015",
        "name": "Light green"
      },
      {
        "id": "283151",
        "name": "Dark orange"
      },
      {
        "id": "52024",
        "name": "Oil blue"
      },
      {
        "id": "52051",
        "name": "Dark grey"
      },
      {
        "id": "283152",
        "name": "Chocolate"
      },
      {
        "id": "52014",
        "name": "Green"
      },
      {
        "id": "283164",
        "name": "Golden"
      },
      {
        "id": "52000",
        "name": "Orange"
      },
      {
        "id": "52033",
        "name": "Dark blue"
      },
      {
        "id": "52010",
        "name": "Ochre"
      },
      {
        "id": "283158",
        "name": "Moss green"
      },
      {
        "id": "52005",
        "name": "Brown"
      },
      {
        "id": "52038",
        "name": "Lilac"
      },
      {
        "id": "52042",
        "name": "Fuchsia"
      },
      {
        "id": "338779",
        "name": "Cyan"
      },
      {
        "id": "52029",
        "name": "Light blue"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "SIZE",
    "name": "Size",
    "tags": {
      "allow_variations": true
    },
    "hierarchy": "CHILD_PK",
    "relevance": 1,
    "value_type": "string",
    "value_max_length": 255,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "FABRIC_DESIGN",
    "name": "Fabric design",
    "tags": {
      "allow_variations": true,
      "defines_picture": true,
      "hidden": true
    },
    "hierarchy": "CHILD_PK",
    "relevance": 1,
    "value_type": "string",
    "value_max_length": 255,
    "values": [
      {
        "id": "508603",
        "name": "Flowered"
      },
      {
        "id": "930483",
        "name": "Plain"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "CHARACTER",
    "name": "Character",
    "tags": {
    },
    "hierarchy": "CHILD_PK",
    "relevance": 1,
    "value_type": "string",
    "value_max_length": 255,
    "values": [
      {
        "id": "963355",
        "name": "The Avengers"
      },
      {
        "id": "507436",
        "name": "Peppa Pig"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "MAIN_COLOR",
    "name": "Main color",
    "tags": {
      "variation_attribute": true
    },
    "hierarchy": "CHILD_DEPENDENT",
    "relevance": 1,
    "type": "color",
    "value_type": "list",
    "values": [
      {
        "id": "2450295",
        "name": "Black",
        "metadata": {
          "rgb": "000000"
        }
      },
      {
        "id": "2450293",
        "name": "Blue",
        "metadata": {
          "rgb": "1717FF"
        }
      },
      {
        "id": "2450307",
        "name": "Red",
        "metadata": {
          "rgb": "FF0000"
        }
      },
      {
        "id": "2450311",
        "name": "Violet",
        "metadata": {
          "rgb": "9F00FF"
        }
      },
      {
        "id": "2450291",
        "name": "Brown",
        "metadata": {
          "rgb": "A0522D"
        }
      },
      {
        "id": "2450314",
        "name": "Green",
        "metadata": {
          "rgb": "0DA600"
        }
      },
      {
        "id": "2450327",
        "name": "Orange",
        "metadata": {
          "rgb": "FF8C00"
        }
      },
      {
        "id": "2450278",
        "name": "Heavenly",
        "metadata": {
          "rgb": "83DDFF"
        }
      },
      {
        "id": "2450312",
        "name": "Pink",
        "metadata": {
          "rgb": "FCB1BE"
        }
      },
      {
        "id": "2450289",
        "name": "Golden",
        "metadata": {
          "rgb": "FFD700"
        }
      },
      {
        "id": "2450296",
        "name": "Yellow",
        "metadata": {
          "rgb": "FFED00"
        }
      },
      {
        "id": "2450294",
        "name": "Grey",
        "metadata": {
          "rgb": "E1E1E1"
        }
      },
      {
        "id": "2450308",
        "name": "Blank",
        "metadata": {
          "rgb": "FFFFFF"
        }
      },
      {
        "id": "2450302",
        "name": "Blue steel",
        "metadata": {
          "rgb": "6FA8DC",
          "parent_id": "2450293"
        }
      },
      {
        "id": "2450298",
        "name": "Light blue",
        "metadata": {
          "rgb": "DCECFF",
          "parent_id": "2450293"
        }
      },
      {
        "id": "2450325",
        "name": "Navy blue",
        "metadata": {
          "rgb": "0F5299",
          "parent_id": "2450293"
        }
      },
      {
        "id": "2450306",
        "name": "Dark blue",
        "metadata": {
          "rgb": "013267",
          "parent_id": "2450293"
        }
      },
      {
        "id": "2450322",
        "name": "Maroon",
        "metadata": {
          "rgb": "830500",
          "parent_id": "2450307"
        }
      },
      {
        "id": "2450318",
        "name": "Coral",
        "metadata": {
          "rgb": "FA8072",
          "parent_id": "2450307"
        }
      },
      {
        "id": "2450313",
        "name": "Light coral",
        "metadata": {
          "rgb": "F9AC95",
          "parent_id": "2450307"
        }
      },
      {
        "id": "2450317",
        "name": "Terracotta",
        "metadata": {
          "rgb": "C63633",
          "parent_id": "2450307"
        }
      },
      {
        "id": "2450316",
        "name": "Lavender",
        "metadata": {
          "rgb": "D9D2E9",
          "parent_id": "2450311"
        }
      },
      {
        "id": "2450321",
        "name": "Lilac",
        "metadata": {
          "rgb": "CC87FF",
          "parent_id": "2450311"
        }
      },
      {
        "id": "2450290",
        "name": "Dark violet",
        "metadata": {
          "rgb": "4E0087",
          "parent_id": "2450311"
        }
      },
      {
        "id": "2450279",
        "name": "Indigo",
        "metadata": {
          "rgb": "7A64C6",
          "parent_id": "2450311"
        }
      },
      {
        "id": "2450281",
        "name": "Beige",
        "metadata": {
          "rgb": "F5F3DC",
          "parent_id": "2450291"
        }
      },
      {
        "id": "2450292",
        "name": "Light brown",
        "metadata": {
          "rgb": "AF8650",
          "parent_id": "2450291"
        }
      },
      {
        "id": "2450297",
        "name": "Dark brown",
        "metadata": {
          "rgb": "5D3806",
          "parent_id": "2450291"
        }
      },
      {
        "id": "2450287",
        "name": "Cleat",
        "metadata": {
          "rgb": "FAEBD7",
          "parent_id": "2450291"
        }
      },
      {
        "id": "2450319",
        "name": "Light green",
        "metadata": {
          "rgb": "9FF39F",
          "parent_id": "2450314"
        }
      },
      {
        "id": "2450305",
        "name": "Lemon green",
        "metadata": {
          "rgb": "73E129",
          "parent_id": "2450314"
        }
      },
      {
        "id": "2450310",
        "name": "Moss green",
        "metadata": {
          "rgb": "3F7600",
          "parent_id": "2450314"
        }
      },
      {
        "id": "2450324",
        "name": "Dark green",
        "metadata": {
          "rgb": "003D00",
          "parent_id": "2450314"
        }
      },
      {
        "id": "2450282",
        "name": "Chocolate",
        "metadata": {
          "rgb": "9B3F14",
          "parent_id": "2450327"
        }
      },
      {
        "id": "2450323",
        "name": "Light orange",
        "metadata": {
          "rgb": "FDAF20",
          "parent_id": "2450327"
        }
      },
      {
        "id": "2450328",
        "name": "Dark orange",
        "metadata": {
          "rgb": "D2691E",
          "parent_id": "2450327"
        }
      },
      {
        "id": "2450286",
        "name": "Fur",
        "metadata": {
          "rgb": "FFE4C4",
          "parent_id": "2450327"
        }
      },
      {
        "id": "2450283",
        "name": "Water",
        "metadata": {
          "rgb": "E0FFFF",
          "parent_id": "2450278"
        }
      },
      {
        "id": "2450288",
        "name": "Oil blue",
        "metadata": {
          "rgb": "1E6E7F",
          "parent_id": "2450278"
        }
      },
      {
        "id": "2450315",
        "name": "Cyan",
        "metadata": {
          "rgb": "00FFFF",
          "parent_id": "2450278"
        }
      },
      {
        "id": "2450320",
        "name": "Turquoise",
        "metadata": {
          "rgb": "40E0D0",
          "parent_id": "2450278"
        }
      },
      {
        "id": "2450326",
        "name": "Fuchsia",
        "metadata": {
          "rgb": "FF00EC",
          "parent_id": "2450312"
        }
      },
      {
        "id": "2450284",
        "name": "Pink gum",
        "metadata": {
          "rgb": "FF51A8",
          "parent_id": "2450312"
        }
      },
      {
        "id": "2450280",
        "name": "Light pink",
        "metadata": {
          "rgb": "FADBE2",
          "parent_id": "2450312"
        }
      },
      {
        "id": "2450285",
        "name": "Dark pink",
        "metadata": {
          "rgb": "D06EA8",
          "parent_id": "2450312"
        }
      },
      {
        "id": "2450301",
        "name": "Khaki",
        "metadata": {
          "rgb": "F0E68C",
          "parent_id": "2450296"
        }
      },
      {
        "id": "2450300",
        "name": "Cream",
        "metadata": {
          "rgb": "FFFFE0",
          "parent_id": "2450296"
        }
      },
      {
        "id": "2450309",
        "name": "Dark gold",
        "metadata": {
          "rgb": "BF9000",
          "parent_id": "2450296"
        }
      },
      {
        "id": "2450304",
        "name": "Ochre",
        "metadata": {
          "rgb": "EACB53",
          "parent_id": "2450296"
        }
      },
      {
        "id": "2450299",
        "name": "Dark grey",
        "metadata": {
          "rgb": "666666",
          "parent_id": "2450294"
        }
      },
      {
        "id": "2450303",
        "name": "Silver",
        "metadata": {
          "rgb": "CBCFD0",
          "parent_id": "2450294"
        }
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "FOOT_LENGTH",
    "name": "Foot length",
    "tags": {
      "hidden": true,
      "variation_attribute": true
    },
    "hierarchy": "CHILD_DEPENDENT",
    "relevance": 1,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": """,
        "name": """
      },
      {
        "id": "cm",
        "name": "cm"
      },
      {
        "id": "mm",
        "name": "mm"
      }
    ],
    "default_unit": "cm",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "FOOT_WIDTH",
    "name": "Foot width",
    "tags": {
      "hidden": true,
      "variation_attribute": true
    },
    "hierarchy": "CHILD_DEPENDENT",
    "relevance": 1,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": """,
        "name": """
      },
      {
        "id": "cm",
        "name": "cm"
      },
      {
        "id": "mm",
        "name": "mm"
      }
    ],
    "default_unit": "cm",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "GENDER",
    "name": "Gender",
    "tags": {
      "fixed": true
    },
    "hierarchy": "FAMILY",
    "relevance": 1,
    "value_type": "list",
    "values": [
      {
        "id": "371795",
        "name": "Babies"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "RELEASE_SEASON",
    "name": "Release season",
    "tags": {
    },
    "hierarchy": "FAMILY",
    "relevance": 1,
    "value_type": "list",
    "values": [
      {
        "id": "994283",
        "name": "Spring-summer"
      },
      {
        "id": "994284",
        "name": "Autumn-winter"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "RELEASE_YEAR",
    "name": "Release year",
    "tags": {
    },
    "hierarchy": "FAMILY",
    "relevance": 1,
    "value_type": "number",
    "value_max_length": 18,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "FOOTWEAR_TYPE",
    "name": "Footwear type",
    "tags": {
      "required": true
    },
    "hierarchy": "FAMILY",
    "relevance": 1,
    "value_type": "string",
    "value_max_length": 255,
    "values": [
      {
        "id": "517583",
        "name": "Sneaker"
      },
      {
        "id": "517587",
        "name": "Crochet shoe"
      },
      {
        "id": "517586",
        "name": "Flip-flop"
      },
      {
        "id": "517585",
        "name": "Sandal"
      },
      {
        "id": "517584",
        "name": "Shoe"
      },
      {
        "id": "517588",
        "name": "Slipper"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "IS_SUITABLE_FOR_FIRST_STEPS",
    "name": "Is suitable for first steps",
    "tags": {
    },
    "hierarchy": "FAMILY",
    "relevance": 1,
    "value_type": "boolean",
    "values": [
      {
        "id": "242084",
        "name": "No",
        "metadata": {
          "value": false
        }
      },
      {
        "id": "242085",
        "name": "Yes",
        "metadata": {
          "value": true
        }
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "FOOTWEAR_MATERIAL",
    "name": "Footwear material",
    "tags": {
    },
    "hierarchy": "FAMILY",
    "relevance": 1,
    "value_type": "string",
    "value_max_length": 255,
    "values": [
      {
        "id": "432125",
        "name": "Canvas"
      },
      {
        "id": "517568",
        "name": "Cotton"
      },
      {
        "id": "3968752",
        "name": "Faux leather"
      },
      {
        "id": "517571",
        "name": "Micropolar"
      },
      {
        "id": "3675718",
        "name": "Patent leather"
      },
      {
        "id": "3675717",
        "name": "Suede"
      },
      {
        "id": "517569",
        "name": "Wool"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "GTIN",
    "name": "Universal product code",
    "tags": {
      "multivalued": true,
      "variation_attribute": true,
      "used_hidden": true,
      "validate": true
    },
    "hierarchy": "PRODUCT_IDENTIFIER",
    "relevance": 1,
    "type": "product_identifier",
    "value_type": "string",
    "value_max_length": 255,
    "tooltip": "How do I recognize it? It is an 8 to 14 digit number next to the barcode, on the product box or on its label. ![Universal product code](https://http2.mlstatic.com/static/org-img/sd-landings/assets/pi-tooltip.png)",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others",
    "hint": "It may be an EAN, UPC or another GTIN."
  },
  {
    "id": "BABIES_FOOTWEAR_SIZE",
    "name": "Babies footwear size",
    "tags": {
      "hidden": true,
      "variation_attribute": true
    },
    "hierarchy": "CHILD_DEPENDENT",
    "relevance": 2,
    "value_type": "string",
    "value_max_length": 255,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "SOLE_TYPE",
    "name": "Sole type",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "string",
    "value_max_length": 255,
    "values": [
      {
        "id": "517576",
        "name": "Flexible"
      },
      {
        "id": "517572",
        "name": "Anti-slip"
      },
      {
        "id": "517574",
        "name": "Rigid"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "CLOSURE_TYPE",
    "name": "Closure type",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "string",
    "value_max_length": 255,
    "values": [
      {
        "id": "1164219",
        "name": "Laces"
      },
      {
        "id": "2771769",
        "name": "Velcro"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "WITH_LIGHTS",
    "name": "With lights",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "boolean",
    "values": [
      {
        "id": "242084",
        "name": "No",
        "metadata": {
          "value": false
        }
      },
      {
        "id": "242085",
        "name": "Yes",
        "metadata": {
          "value": true
        }
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "PAIRS_NUMBER",
    "name": "Pairs number",
    "tags": {
      "hidden": true
    },
    "hierarchy": "ITEM",
    "relevance": 2,
    "value_type": "number",
    "value_max_length": 18,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "ITEM_CONDITION",
    "name": "Item condition",
    "tags": {
      "hidden": true
    },
    "hierarchy": "ITEM",
    "relevance": 2,
    "value_type": "list",
    "values": [
      {
        "id": "2230284",
        "name": "New"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "MPN",
    "name": "MPN",
    "tags": {
      "hidden": true,
      "multivalued": true,
      "variation_attribute": true
    },
    "hierarchy": "PRODUCT_IDENTIFIER",
    "relevance": 2,
    "type": "product_identifier",
    "value_type": "string",
    "value_max_length": 255,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "SELLER_SKU",
    "name": "SKU",
    "tags": {
      "hidden": true,
      "variation_attribute": true
    },
    "hierarchy": "ITEM",
    "relevance": 1,
    "value_type": "string",
    "value_max_length": 255,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "IS_FLAMMABLE",
    "name": "Is flammable",
    "tags": {
      "hidden": true,
      "read_only": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "boolean",
    "values": [
      {
        "id": "242084",
        "name": "No",
        "metadata": {
          "value": false
        }
      },
      {
        "id": "242085",
        "name": "Yes",
        "metadata": {
          "value": true
        }
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "IS_KIT",
    "name": "Is kit",
    "tags": {
      "hidden": true
    },
    "hierarchy": "ITEM",
    "relevance": 2,
    "value_type": "boolean",
    "values": [
      {
        "id": "242084",
        "name": "No",
        "metadata": {
          "value": false
        }
      },
      {
        "id": "242085",
        "name": "Yes",
        "metadata": {
          "value": true
        }
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "DESCRIPTIVE_TAGS",
    "name": "Descriptive tags",
    "tags": {
      "hidden": true,
      "multivalued": true,
      "read_only": true
    },
    "hierarchy": "ITEM",
    "relevance": 2,
    "value_type": "string",
    "value_max_length": 255,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "PACKAGE_LENGTH",
    "name": "Package length",
    "tags": {
      "hidden": true,
      "variation_attribute": true
    },
    "hierarchy": "ITEM",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "mm",
        "name": "mm"
      },
      {
        "id": "U",
        "name": "U"
      },
      {
        "id": "hh",
        "name": "hh"
      },
      {
        "id": "cm",
        "name": "cm"
      },
      {
        "id": "µm",
        "name": "µm"
      },
      {
        "id": "km",
        "name": "km"
      },
      {
        "id": "m",
        "name": "m"
      },
      {
        "id": "pulgadas",
        "name": "pulgadas"
      },
      {
        "id": "in",
        "name": "in"
      },
      {
        "id": "yd",
        "name": "yd"
      },
      {
        "id": """,
        "name": """
      },
      {
        "id": "nm",
        "name": "nm"
      },
      {
        "id": "ft",
        "name": "ft"
      }
    ],
    "default_unit": "cm",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "PACKAGE_WEIGHT",
    "name": "Package weight",
    "tags": {
      "hidden": true,
      "variation_attribute": true
    },
    "hierarchy": "ITEM",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "mcg",
        "name": "mcg"
      },
      {
        "id": "mg",
        "name": "mg"
      },
      {
        "id": "t",
        "name": "t"
      },
      {
        "id": "lb",
        "name": "lb"
      },
      {
        "id": "g",
        "name": "g"
      },
      {
        "id": "oz",
        "name": "oz"
      },
      {
        "id": "kg",
        "name": "kg"
      }
    ],
    "default_unit": "g",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "PACKAGE_WIDTH",
    "name": "Package width",
    "tags": {
      "hidden": true,
      "variation_attribute": true
    },
    "hierarchy": "ITEM",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "mm",
        "name": "mm"
      },
      {
        "id": "U",
        "name": "U"
      },
      {
        "id": "hh",
        "name": "hh"
      },
      {
        "id": "cm",
        "name": "cm"
      },
      {
        "id": "µm",
        "name": "µm"
      },
      {
        "id": "km",
        "name": "km"
      },
      {
        "id": "m",
        "name": "m"
      },
      {
        "id": "pulgadas",
        "name": "pulgadas"
      },
      {
        "id": "in",
        "name": "in"
      },
      {
        "id": "yd",
        "name": "yd"
      },
      {
        "id": """,
        "name": """
      },
      {
        "id": "nm",
        "name": "nm"
      },
      {
        "id": "ft",
        "name": "ft"
      }
    ],
    "default_unit": "cm",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "PACKAGE_HEIGHT",
    "name": "Package height",
    "tags": {
      "hidden": true,
      "variation_attribute": true
    },
    "hierarchy": "ITEM",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "mm",
        "name": "mm"
      },
      {
        "id": "U",
        "name": "U"
      },
      {
        "id": "hh",
        "name": "hh"
      },
      {
        "id": "cm",
        "name": "cm"
      },
      {
        "id": "µm",
        "name": "µm"
      },
      {
        "id": "km",
        "name": "km"
      },
      {
        "id": "m",
        "name": "m"
      },
      {
        "id": "pulgadas",
        "name": "pulgadas"
      },
      {
        "id": "in",
        "name": "in"
      },
      {
        "id": "yd",
        "name": "yd"
      },
      {
        "id": """,
        "name": """
      },
      {
        "id": "nm",
        "name": "nm"
      },
      {
        "id": "ft",
        "name": "ft"
      }
    ],
    "default_unit": "cm",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "PRODUCT_FEATURES",
    "name": "Product features",
    "tags": {
      "hidden": true,
      "multivalued": true,
      "read_only": true
    },
    "hierarchy": "ITEM",
    "relevance": 2,
    "value_type": "list",
    "values": [
      {
        "id": "7435885",
        "name": "Contains liquid"
      },
      {
        "id": "7435883",
        "name": "Fragile"
      },
      {
        "id": "7435888",
        "name": "With expiration"
      },
      {
        "id": "7575917",
        "name": "Disinfectant and sanitizer"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "PRODUCT_CHEMICAL_FEATURES",
    "name": "Product chemical features",
    "tags": {
      "hidden": true,
      "multivalued": true,
      "read_only": true
    },
    "hierarchy": "ITEM",
    "relevance": 2,
    "value_type": "list",
    "values": [
      {
        "id": "7651070",
        "name": "Flammable"
      },
      {
        "id": "7651071",
        "name": "Aerosol"
      },
      {
        "id": "7651072",
        "name": "Oxidizer"
      },
      {
        "id": "7651073",
        "name": "Corrosive"
      },
      {
        "id": "7651074",
        "name": "Explosive"
      },
      {
        "id": "7651075",
        "name": "Toxic or infectious"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "FOODS_AND_DRINKS",
    "name": "Foods and drinks",
    "tags": {
      "hidden": true,
      "multivalued": true,
      "read_only": true
    },
    "hierarchy": "ITEM",
    "relevance": 2,
    "value_type": "list",
    "values": [
      {
        "id": "7575926",
        "name": "For humans"
      },
      {
        "id": "7575927",
        "name": "For animals"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "MEDICINES",
    "name": "Medicines",
    "tags": {
      "hidden": true,
      "multivalued": true,
      "read_only": true
    },
    "hierarchy": "ITEM",
    "relevance": 2,
    "value_type": "list",
    "values": [
      {
        "id": "7575930",
        "name": "For humans with a medical prescription"
      },
      {
        "id": "7575931",
        "name": "For humans without a medical prescription"
      },
      {
        "id": "7575932",
        "name": "For animals with a medical prescription"
      },
      {
        "id": "7575933",
        "name": "For animals without a medical prescription"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "BATTERIES_FEATURES",
    "name": "Batteries features",
    "tags": {
      "hidden": true,
      "multivalued": true,
      "read_only": true
    },
    "hierarchy": "ITEM",
    "relevance": 2,
    "value_type": "list",
    "values": [
      {
        "id": "7575934",
        "name": "Stand-alone lithium (loose or isolated)"
      },
      {
        "id": "7575935",
        "name": "Lithium installed"
      },
      {
        "id": "7575936",
        "name": "For cars (lead-acid)"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "SHIPMENT_PACKING",
    "name": "Shipment packing",
    "tags": {
      "hidden": true,
      "multivalued": true,
      "read_only": true
    },
    "hierarchy": "ITEM",
    "relevance": 2,
    "value_type": "list",
    "values": [
      {
        "id": "7435891",
        "name": "Bag"
      },
      {
        "id": "7435892",
        "name": "Box"
      },
      {
        "id": "7575937",
        "name": "Envelope"
      },
      {
        "id": "7575938",
        "name": "Voluminous"
      },
      {
        "id": "7575939",
        "name": "Self-shipping"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "ADDITIONAL_INFO_REQUIRED",
    "name": "Additional info required",
    "tags": {
      "hidden": true,
      "multivalued": true,
      "read_only": true
    },
    "hierarchy": "ITEM",
    "relevance": 2,
    "value_type": "list",
    "values": [
      {
        "id": "7435893",
        "name": "Has IMEI"
      },
      {
        "id": "7435894",
        "name": "Has serial number"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "EXCLUSIVE_CHANNEL",
    "name": "Exclusive channel",
    "tags": {
      "hidden": true
    },
    "hierarchy": "ITEM",
    "relevance": 2,
    "value_type": "list",
    "values": [
      {
        "id": "7865258",
        "name": "Mercado Shops"
      },
      {
        "id": "7865259",
        "name": "Mercado Libre"
      },
      {
        "id": "7889418",
        "name": "Private"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "IS_SUITABLE_FOR_SHIPMENT",
    "name": "Is suitable for shipment",
    "tags": {
      "hidden": true,
      "read_only": true
    },
    "hierarchy": "ITEM",
    "relevance": 2,
    "value_type": "boolean",
    "values": [
      {
        "id": "242084",
        "name": "No",
        "metadata": {
          "value": false
        }
      },
      {
        "id": "242085",
        "name": "Yes",
        "metadata": {
          "value": true
        }
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  }
]

Then, you just need to analyze the available attributes, their types and suggested values to make the listing JSON, including the attributes section. Find below how to do it:

curl -X POST http://api.mercadolibre.com/items/?access_token=$ACCESS_TOKEN
  -d '{
  "listing_type_id": "gold_pro",
  "title": "Test Item - for LoadTest tests",
  "available_quantity": 100,
  "category_id": "CBT11796",
  "buying_mode": "buy_it_now",
  "currency_id": "USD",
  "condition": "new",
  "site_id": "CBT",
  "price": 15.1,
  "sale_terms": [
    {
      "id": "WARRANTY_TIME",
      "value_name": "90 days"
    },
    {
      "id": "WARRANTY_TYPE",
      "value_id": "2230279"
    }
  ],
  "attributes": [
    {
      "id": "PACKAGE_HEIGHT",
      "value_name": "10 cm"
    },
    {
      "id": "PACKAGE_WIDTH",
      "value_name": "10 cm"
    },
    {
      "id": "PACKAGE_LENGTH",
      "value_name": "10 cm"
    },
    {
      "id": "PACKAGE_WEIGHT",
      "value_name": "0.7 lb"
    },
    {
      "id": "BRAND",
      "value_name": "DOMINIQ"
    },
    {
      "id": "FOOTWEAR_TYPE",
      "value_id": "517583"
    },
    {
      "id": "GENDER",
      "value_id": "371795"
    },
    {
      "id": "ITEM_CONDITION",
      "value_id": "2230284"
    },
    {
      "id": "MODEL",
      "value_name": "A-59081-6"
    }
  ],
  "pictures": [
    {
      "id": "691535-MLA29134565196_012019",
      "max_size": "500x500",
      "quality": "",
      "secure_url": "https://www.mercadolibre.com/jm/img?s=STC&v=O&f=proccesing_image_es.jpg",
      "size": "500x500",
      "url": "http://www.mercadolibre.com/jm/img?s=STC&v=O&f=proccesing_image_es.jpg"
    }
  ],
  "description": {
    "plain_text": "this is a test item"
  }
}'

Remember:

  • Attributes can be added to items at any time during their life cycle.
  • If the attribute has a suggested_values list, you can send either one of those values or a new one. To send new values you must only send the value_name but for the existing values, sending the value_id is enough.
  • For list-type attributes, you should only send values included in such list. Sending only the value_id is enough. If you wish to enter a value that is not on the list, you can do so by sending your custom value in value_name with the value_id that is closest to yours.
  • All the main attributes are identified as MAIN in the field attribute_group_id while, the secondary attributes will be differentiated under other values such as: DELT.
  • Take into account that in categories that include primary and secondary colors, as an exception, it will not be necessary that all the variations duplicate both attributes.

Change and/or add attributes

Once the listing is created, you can add new attributes or change the existing ones. Let's assume that you want to change the Microwave Oven Model and add the Number of Programs. First, we suggest you should make a GET to know the attributes already filled out (for example, Model).
Request:

curl -X GET https://api.mercadolibre.com/items/$ITEM_ID

Example:

curl -X GET http://api.mercadolibre.com/items/CBT926679283

Response:

{
    "id": "CBT926679283",
    "site_id": "CBT",
    "title": "Test Item - For Loadtest Tests",
    "subtitle": null,
    "seller_id": 523130418,
    "category_id": "CBT11796",
    "official_store_id": null,
    "price": 15.1,
    "base_price": 15.1,
    "original_price": null,
    "currency_id": "USD",
    "initial_quantity": 100,
    "available_quantity": 50,
    "sold_quantity": 0,
    "sale_terms": [
        {
            "id": "WARRANTY_TYPE",
            "name": "Type of warranty",
            "value_id": "2230279",
            "value_name": "Factory warranty",
            "value_struct": null,
            "values": [
                {
                    "id": "2230279",
                    "name": "Factory warranty",
                    "struct": null
                }
            ]
        },
        {
            "id": "WARRANTY_TIME",
            "name": "Warranty time",
            "value_id": null,
            "value_name": "90 days",
            "value_struct": {
                "number": 90,
                "unit": "days"
            },
            "values": [
                {
                    "id": null,
                    "name": "90 days",
                    "struct": {
                        "number": 90,
                        "unit": "days"
                    }
                }
            ]
        }
    ],
    "buying_mode": "buy_it_now",
    "listing_type_id": "gold_pro",
    "start_time": "2020-05-11T23:09:18.000Z",
    "stop_time": "2040-05-06T04:00:00.000Z",
    "condition": "new",
    "permalink": "",
    "thumbnail": "http://cbt-s2-p.mlstatic.com/691535-MLA29134565196_012019-I.jpg",
    "secure_thumbnail": "https://cbt-s2-p.mlstatic.com/691535-MLA29134565196_012019-I.jpg",
    "pictures": [
        {
            "id": "691535-MLA29134565196_012019",
            "url": "http://cbt-s2-p.mlstatic.com/691535-MLA29134565196_012019-O.jpg",
            "secure_url": "https://cbt-s2-p.mlstatic.com/691535-MLA29134565196_012019-O.jpg",
            "size": "500x500",
            "max_size": "500x500",
            "quality": ""
        }
    ],
    "video_id": null,
    "descriptions": [
        {
            "id": "CBT926679283-2654908016"
        }
    ],
    "accepts_mercadopago": true,
    "non_mercado_pago_payment_methods": [],
    "shipping": {
        "mode": "not_specified",
        "methods": [],
        "tags": [],
        "dimensions": null,
        "local_pick_up": false,
        "free_shipping": false,
        "logistic_type": "not_specified",
        "store_pick_up": false
    },
    "international_delivery_mode": "none",
    "seller_address": {
        "city": {
            "id": "Q04tQ1FDaG9uZ3Fpbmc",
            "name": "Chongqing"
        },
        "state": {
            "id": "CN-CQ",
            "name": "Chongqing"
        },
        "country": {
            "id": "CN",
            "name": "China"
        },
        "id": 1086581840
    },
    "seller_contact": null,
    "location": {},
    "coverage_areas": [],
    "attributes": [
        {
            "id": "BRAND",
            "name": "Brand",
            "value_id": null,
            "value_name": "DOMINIQ",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "DOMINIQ",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Others"
        },
        {
            "id": "FOOTWEAR_TYPE",
            "name": "Footwear type",
            "value_id": "517583",
            "value_name": "Sneaker",
            "value_struct": null,
            "values": [
                {
                    "id": "517583",
                    "name": "Sneaker",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Others"
        },
        {
            "id": "GENDER",
            "name": "Gender",
            "value_id": "371795",
            "value_name": "Babies",
            "value_struct": null,
            "values": [
                {
                    "id": "371795",
                    "name": "Babies",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Others"
        },
        {
            "id": "ITEM_CONDITION",
            "name": "Item condition",
            "value_id": "2230284",
            "value_name": "New",
            "value_struct": null,
            "values": [
                {
                    "id": "2230284",
                    "name": "New",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Others"
        },
        {
            "id": "MODEL",
            "name": "Model",
            "value_id": null,
            "value_name": "A-59081-6",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "A-59081-6",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Others"
        },
        {
            "id": "PACKAGE_HEIGHT",
            "name": "Package height",
            "value_id": null,
            "value_name": "10 cm",
            "value_struct": {
                "number": 10,
                "unit": "cm"
            },
            "values": [
                {
                    "id": null,
                    "name": "10 cm",
                    "struct": {
                        "number": 10,
                        "unit": "cm"
                    }
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Others"
        },
        {
            "id": "PACKAGE_LENGTH",
            "name": "Package length",
            "value_id": null,
            "value_name": "10 cm",
            "value_struct": {
                "number": 10,
                "unit": "cm"
            },
            "values": [
                {
                    "id": null,
                    "name": "10 cm",
                    "struct": {
                        "number": 10,
                        "unit": "cm"
                    }
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Others"
        },
        {
            "id": "PACKAGE_WEIGHT",
            "name": "Package weight",
            "value_id": null,
            "value_name": "0.7 lb",
            "value_struct": {
                "number": 0.7,
                "unit": "lb"
            },
            "values": [
                {
                    "id": null,
                    "name": "0.7 lb",
                    "struct": {
                        "number": 0.7,
                        "unit": "lb"
                    }
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Others"
        },
        {
            "id": "PACKAGE_WIDTH",
            "name": "Package width",
            "value_id": null,
            "value_name": "10 cm",
            "value_struct": {
                "number": 10,
                "unit": "cm"
            },
            "values": [
                {
                    "id": null,
                    "name": "10 cm",
                    "struct": {
                        "number": 10,
                        "unit": "cm"
                    }
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Others"
        }
    ],
    "warnings": [],
    "listing_source": "",
    "variations": [],
    "status": "active",
    "sub_status": [],
    "tags": [
        "immediate_payment"
    ],
    "catalog_product_id": null,
    "domain_id": "CBT-BABIES_FOOTWEAR",
    "parent_item_id": null,
    "differential_pricing": null,
    "deal_ids": [],
    "automatic_relist": false,
    "date_created": "2020-05-11T23:09:18.000Z",
    "last_updated": "2020-05-11T23:09:22.000Z",
    "health": null,
    "catalog_listing": false
}

You will need to load this attribute when you make a PUT not to lose information.
Ready to make an update? Make a PUT including new attributes, such as Number of Programs, and those you already had (such as Model).


curl -X PUT http://api.mercadolibre.com/items/CBT926679283?access_token=$ACCESS_TOKEN
  -d '{
    "attributes": [
        {
            "id": "BRAND",
            "name": "Brand",
            "value_name": "DOMINIQ"
        },
        {
            "id": "FOOTWEAR_TYPE",
            "value_id": "517583",
            "value_name": "Sneaker"
        },
        {
            "value_name": "Babies",
            "id": "GENDER",
            "value_id": "371795"
        },
        {
            "value_id": "2230284",
            "value_name": "New",
            "id": "ITEM_CONDITION"
        },
        {
            "value_name": "A-59081-6",
            "value_struct": null,
            "id": "MODEL"
        },
        {
            "id": "PACKAGE_HEIGHT",
            "name": "Package height",
            "value_name": "10 cm"
        },
        {
            "value_name": "10 cm",
            "id": "PACKAGE_LENGTH"
        },
        {
            "id": "PACKAGE_WEIGHT",
            "value_name": "0.7 lb"
        },
        {
            "name": "Package width",
            "value_name": "10 cm",
            "id": "PACKAGE_WIDTH"
        },
        {
            "name": "COLOR",
            "value_id": "52019"
        }
    ]
}'

Delete attributes

The correct way to eliminate the attribute value is by sending null in the "value_id" and "value_name" fields. This way, the attribute remains in the item, but without value. If any data is required and you try to send "null", we will return a bad request with the following error code: "code": "item.attributes.deleted_required" Request:

curl -X PUT https://api.mercadolibre.com/items/$ITEM_ID?access_token=$ACCESS_TOKEN

Example:

curl -X PUT 'http://api.mercadolibre.com/items/CBT926679283?access_token=$ACCESS_TOKEN
  -d '{
    "attributes": [
        {
            "id": "BRAND",
            "name": "Brand",
            "value_name": "DOMINIQ"
        },
        {
            "id": "FOOTWEAR_TYPE",
            "value_id": "517583",
            "value_name": "Sneaker"
        },
        {
            "value_name": "Babies",
            "id": "GENDER",
            "value_id": "371795"
        },
        {
            "value_id": "2230284",
            "value_name": "New",
            "id": "ITEM_CONDITION"
        },
        {
            "value_name": "A-59081-6",
            "value_struct": null,
            "id": "MODEL"
        },
        {
            "id": "PACKAGE_HEIGHT",
            "name": "Package height",
            "value_name": "10 cm"
        },
        {
            "value_name": "10 cm",
            "id": "PACKAGE_LENGTH"
        },
        {
            "id": "PACKAGE_WEIGHT",
            "value_name": "0.7 lb"
        },
        {
            "name": "Package width",
            "value_name": "10 cm",
            "id": "PACKAGE_WIDTH"
        }
    ]
}'

Response:

{
    "id": "CBT926679283",
    "site_id": "CBT",
    "title": "Test Item - For Loadtest Tests",
    "subtitle": null,
    "seller_id": 523130418,
    "category_id": "CBT11796",
    "official_store_id": null,
    "price": 15.1,
    "base_price": 15.1,
    "original_price": null,
    "inventory_id": null,
    "currency_id": "USD",
    "initial_quantity": 100,
    "available_quantity": 100,
    "sold_quantity": 0,
    "sale_terms": [
        {
            "id": "WARRANTY_TYPE",
            "name": "Type of warranty",
            "value_id": "2230279",
            "value_name": "Factory warranty",
            "value_struct": null,
            "values": [
                {
                    "id": "2230279",
                    "name": "Factory warranty",
                    "struct": null
                }
            ]
        },
        {
            "id": "WARRANTY_TIME",
            "name": "Warranty time",
            "value_id": null,
            "value_name": "90 days",
            "value_struct": {
                "unit": "days",
                "number": 90
            },
            "values": [
                {
                    "id": null,
                    "name": "90 days",
                    "struct": {
                        "number": 90,
                        "unit": "days"
                    }
                }
            ]
        }
    ],
    "buying_mode": "buy_it_now",
    "listing_type_id": "gold_pro",
    "start_time": "2020-05-11T23:09:18.000Z",
    "stop_time": "2040-05-06T04:00:00.000Z",
    "end_time": "2040-05-06T04:00:00.000Z",
    "expiration_time": "2020-07-30T23:09:18.000Z",
    "condition": "new",
    "permalink": "",
    "pictures": [
        {
            "id": "691535-MLA29134565196_012019",
            "url": "http://mla-s2-p.mlstatic.com/691535-MLA29134565196_012019-O.jpg",
            "secure_url": "https://mla-s2-p.mlstatic.com/691535-MLA29134565196_012019-O.jpg",
            "size": "500x500",
            "max_size": "500x500",
            "quality": ""
        }
    ],
    "video_id": null,
    "descriptions": [
        {
            "id": "CBT926679283-2654908016"
        }
    ],
    "accepts_mercadopago": true,
    "non_mercado_pago_payment_methods": [],
    "shipping": {
        "mode": "not_specified",
        "local_pick_up": false,
        "free_shipping": false,
        "methods": [],
        "dimensions": null,
        "tags": [],
        "logistic_type": "not_specified",
        "store_pick_up": false
    },
    "international_delivery_mode": "none",
    "seller_address": {
        "id": 1086581840,
        "comment": "",
        "address_line": "498 NW 3rd Av",
        "zip_code": "12345",
        "city": {
            "id": "Q04tQ1FDaG9uZ3Fpbmc",
            "name": "Chongqing"
        },
        "state": {
            "id": "CN-CQ",
            "name": "Chongqing"
        },
        "country": {
            "id": "CN",
            "name": "China"
        },
        "latitude": "",
        "longitude": "",
        "search_location": {
            "neighborhood": {
                "id": "",
                "name": ""
            },
            "city": {
                "id": "",
                "name": ""
            },
            "state": {
                "id": "",
                "name": ""
            }
        }
    },
    "seller_contact": null,
    "location": {},
    "geolocation": {
        "latitude": "",
        "longitude": ""
    },
    "coverage_areas": [],
    "attributes": [
        {
            "id": "MODEL",
            "name": "Model",
            "value_id": null,
            "value_name": "A-59081-6",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "A-59081-6",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Others"
        },
        {
            "id": "BRAND",
            "name": "Brand",
            "value_id": null,
            "value_name": "DOMINIQ",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "DOMINIQ",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Others"
        },
        {
            "id": "PACKAGE_WEIGHT",
            "name": "Package weight",
            "value_id": null,
            "value_name": "0.7 lb",
            "value_struct": {
                "unit": "lb",
                "number": 0.7
            },
            "values": [
                {
                    "id": null,
                    "name": "0.7 lb",
                    "struct": {
                        "number": 0.7,
                        "unit": "lb"
                    }
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Others"
        },
        {
            "id": "GENDER",
            "name": "Gender",
            "value_id": "371795",
            "value_name": "Babies",
            "value_struct": null,
            "values": [
                {
                    "id": "371795",
                    "name": "Babies",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Others"
        },
        {
            "id": "PACKAGE_HEIGHT",
            "name": "Package height",
            "value_id": null,
            "value_name": "10 cm",
            "value_struct": {
                "unit": "cm",
                "number": 10
            },
            "values": [
                {
                    "id": null,
                    "name": "10 cm",
                    "struct": {
                        "number": 10,
                        "unit": "cm"
                    }
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Others"
        },
        {
            "id": "ITEM_CONDITION",
            "name": "Item condition",
            "value_id": "2230284",
            "value_name": "New",
            "value_struct": null,
            "values": [
                {
                    "id": "2230284",
                    "name": "New",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Others"
        },
        {
            "id": "FOOTWEAR_TYPE",
            "name": "Footwear type",
            "value_id": "517583",
            "value_name": "Sneaker",
            "value_struct": null,
            "values": [
                {
                    "id": "517583",
                    "name": "Sneaker",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Others"
        },
        {
            "id": "PACKAGE_WIDTH",
            "name": "Package width",
            "value_id": null,
            "value_name": "10 cm",
            "value_struct": {
                "unit": "cm",
                "number": 10
            },
            "values": [
                {
                    "id": null,
                    "name": "10 cm",
                    "struct": {
                        "number": 10,
                        "unit": "cm"
                    }
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Others"
        },
        {
            "id": "PACKAGE_LENGTH",
            "name": "Package length",
            "value_id": null,
            "value_name": "10 cm",
            "value_struct": {
                "unit": "cm",
                "number": 10
            },
            "values": [
                {
                    "id": null,
                    "name": "10 cm",
                    "struct": {
                        "number": 10,
                        "unit": "cm"
                    }
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Others"
        }
    ],
    "warnings": [],
    "listing_source": "",
    "variations": [],
    "thumbnail": "http://cbt-s2-p.mlstatic.com/691535-MLA29134565196_012019-I.jpg",
    "secure_thumbnail": "https://cbt-s2-p.mlstatic.com/691535-MLA29134565196_012019-I.jpg",
    "status": "active",
    "sub_status": [],
    "tags": [
        "immediate_payment"
    ],
    "catalog_product_id": null,
    "domain_id": "CBT-BABIES_FOOTWEAR",
    "seller_custom_field": null,
    "parent_item_id": null,
    "differential_pricing": null,
    "deal_ids": [],
    "automatic_relist": false,
    "date_created": "2020-05-11T23:09:18.000Z",
    "last_updated": "2020-05-11T23:14:41.463Z",
    "health": null,
    "catalog_listing": false,
    "item_relations": []
}

Next: Product identifiers.