Item Description

Item description contains customized information about the product for sale, which supplements the standard description.

What kind of information should the description include?

It should include the technical characteristics and the differentiators against competition.

Contents

Uploading item description

Through the API, you can work with descriptions containing both HTML and plain text. To figure out what format you can use, you should take into account the country where the user operates or if it is a classified listing.

How can I list in both formats?

curl -X POST -H "Content-Type: application/json" -d
'{
    "title": "Item de test - No Ofertar",
    "category_id": "MLA47392",
    "price": 10,
    "currency_id": "ARS",
    "available_quantity": 1,
    "buying_mode": "buy_it_now",
    "listing_type_id": "gold_special",
    "condition": "new",
    "description":{
                    "text":"Descripción con HTML",
                    "plain_text":"Descripción con Texto Plano  \n"},
    "video_id": "YOUTUBE_ID_HERE",
    "tags": [
        "immediate_payment"
    ],
    "warranty": "12 months by Ray Ban",
    "pictures": [
        {
            "source": "https://upload.wikimedia.org/wikipedia/commons/f/fd/Ray_Ban_Original_Wayfarer.jpg"
        },
        {
            "source": "https://en.wikipedia.org/wiki/File:Teashades.gif"
        }
    ]
}'
https://api.mercadolibre.com/items?access_token=$access_token

Benefits of using plain text

  • Descriptions can be downloaded 5 times faster.
  • They will be properly displayed in all devices (mobile, tablets, computer).
  • They will have better results in searches.
  • Search Boost; listings will be displayed higher when loading the item data sheet.
  • Besides, you will be able to upload up to 10 item pictures and/or a link with a YouTube video.

Find below an example of the best practice to prepare a description:
Item: “Babolat Pure Control 3 Racket”

Notes:

  • Bear in mind that you can add any payment and shipping method that you wish to the VIP.
  • If you want your listing to show all item variations, even differential stock for each of them, we encourage you to use customized variations.
  • Bear in mind that if you list on MLA using html and plain text, the priority will be given to the latter.
  • Adding or replacing an existing description

    If you sent an empty description when listing an item, you can add it later. The same applies to changing the existing description.
    Example:

    curl -X PUT -H "Content-Type: application/json" -d
    '{
     "text":"Los mejores <b>Rayban Wayfarer</b>. Test",
    "plain_text":"Los mejores Rayban Wayfarer. Test."
    }'
    https://api.mercadolibre.com/items/{ITEM_ID}/description?access_token=$ACCESS_TOKEN

    Important: Bear in mind that if you have listings in both formats and you make a PUT with one of them only (e.g., you send only “plain_text” in the body), the other one will be deleted. If you want to keep them, you should send both; otherwise, we assume that you want to delete it.

    Can you see? It’s easy! Descriptions can be added or replaced whenever you want, even if there are bids for the item. So, get on with it and prepare an excellent description for your items!

    Please rate this