Sellers might want to modify an existing listing description for an active listing, or in some cases, they may want to completely replace the listing description. A scenario where a seller might want to modify the listing description might be a response to a buyer's question that all potential buyers should know.

The following calls can be used to revise the listing description:

When using one of the Revise calls, include the Item.DescriptionReviseMode field in the request as well as one of the following supported values defined in DescriptionReviseModeCodeType:

  • Replace

    This value is used if the seller would like to fully replace the current listing description. If this option is selected, the Item.Description field must also be included in the Revise request, and whatever text is passed into that field will become the new listing description.

  • Prepend

    This value is used if the seller would like to add additional text at the beginning of what is currently in the listing description. If this option is selected, the Item.Description field does not need to be included in the Revise request.

  • Append

    This value is used if the seller would like to add additional text at the end of what is currently in the listing description. If this option is selected, the Item.Description field does not need to be included in the Revise request.

The AddToItemDescription call is used to add information to the end of the current listing description of an item. This call serves the same purpose as the Item.DescriptionReviseMode field of a Revise if the Append value is used. This call cannot be used to completely replace the current listing description, nor can it be used to add text at the beginning of the listing description.

In an AddToItemDescription call, the listing to modify is identified through the ItemID field, and the text to append to the end of the current listing description is passed into the Description field.