Skip to main content
Published: January 22 2007, 2:30:00 PMUpdated: November 28 2020, 3:14:26 PM

What is the best way to go about changing the Description of an Item?

Summary

The ReviseItem call has a way to change the description by indicating exactly what you want to do with the data you send in the Description element of the ReviseItem call.

The DescriptionReviseMode element is used to indicate what action you want to take.
The following 3 actions can be taken:

  • Replace
    By specifying <DescriptionReviseMode>Replace</DescriptionReviseMode> in your ReviseItem call, the data you send in the Description element will completely replace the existing Description.  Please note that this is a complete and non reversible action.  Once the call is made, the item description will be the data that you sent in the Description element. As an example, if the following ReviseItem call is made, the item's entire description will then be "data".

        <?xml version="1.0" encoding="utf-8"?>
        <ReviseItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
             <Version>497</Version>
             <ErrorLanguage>en_US</ErrorLanguage>
             <WarningLevel>High</WarningLevel>
             <Item>
                  <ItemID>123</ItemID>
                  <Description>data</Description>
                  <DescriptionReviseMode>Replace</DescriptionReviseMode>
             </Item>
             <RequesterCredentials>
                  <eBayAuthToken>token</eBayAuthToken>
             </RequesterCredentials>
        </ReviseItemRequest>
  • Prepend
    By specifying <DescriptionReviseMode>Prepend</DescriptionReviseMode> in your ReviseItem call, the data you send in the Description element will be prepended to the existing Description.  Once the call is made, the item description will be the data that you sent in the Description element followed by the previously existing description.
  • Append
    By specifying <DescriptionReviseMode>Append</DescriptionReviseMode> in your ReviseItem call, the data you send in the Description element will be appended to the existing Description.  Once the call is made, the item description will be the previously existing description followed by the data that you sent in the Description element.

Additional Resources

How well did this answer your question?
Answers others found helpful