Sell on Amazon Sign in
This article applies to selling in: United States

Condition Types Integration

To include condition type for a product, you add the Condition element in the product feed. If you use text files, you also add condition information.

Note: The integration processes discussed in this topic do not apply to Books, Music, Video and DVD products. For more information, see Inventory Loader Instructions and File Formats for BMVD.

Condition types

Note: Condition types are case-sensitive. "New" is not the same as "new".

The following Condition Types are available, depending on product category:

Element Description Data Definition
New A brand-new, unused item in perfect condition. Optional field. Acceptable value is:

New.

Refurbished A product that is professionally restored to working order. Typically, this means the product is inspected, cleaned, and repaired to meet manufacturer specifications. The product might not be in its original packaging. The manufacturer warranty or warranty of the company performing the refurbishing services might apply to the product and should be included in the "Condition comments". Optional field. Acceptable value is:

Refurbished.

Used A used item may be fairly worn or in perfect condition, but must still work perfectly. Optional field. Acceptable value is:

Used.

Must be combined with a subtype.

Collectible Collectible items should be rare, signed, out of print/distribution, or otherwise unique--you can detail why your copy is collectible. Optional field. Acceptable value is:

Collectible.

Must be combined with a subtype.

The Used and Collectible condition types are further clarified for a more exact description of the condition, as shown in this table.

Note: Note that the definitions are also case-sensitive:
Element Description Data Definition
Like New An apparently untouched product, in perfect condition. The original plastic wrap might be missing, but the original packaging is intact and pristine, and instructions are included. There are absolutely no signs of wear. Suitable for presenting as a gift. Optional field. Must be combined with appropriate condition type:

UsedLikeNew

CollectibleLikeNew

Very Good A well-cared-for product with limited use but still in great condition. The product is complete, unmarked, and undamaged, but might show some limited signs of wear. The product works perfectly. Optional field. Must be combined with appropriate condition type:

UsedVeryGood

CollectibleVeryGood

Good The product shows wear from consistent use, but remains in good condition. The product might be marked or have identifying information it, and show other signs of previous use. The product works perfectly. Optional field. Must be combined with appropriate condition type:

UsedGood

CollectibleGood

Acceptable The product is fairly worn, but it continues to work perfectly. The signs of wear can include scratches, dents, and other aesthetic problems. The product might be marked or have identifying information it, and show other signs of previous use. Optional field. Must be combined with appropriate condition type:

UsedAcceptable

CollectibleAcceptable

Descriptors for Used and Collectible Types

For more information about establishing a product's condition, see the Condition Guidelines.

Product Feed Message Example

<Product> 
<SKU>ABC123SKU</SKU> 
<StandardProductID> 
<Type>ASIN</Type> 
<Value>B000000000</Value> 
</StandardProductID> 
<LaunchDate>11-11-2003H09:30:47-05:00</LaunchDate> 
<Condition> 
<ConditionType>UsedLikeNew</ConditionType> 
</Condition> 
</Product>

Testing Condition Types

To test text file and XML implementations:

  1. Submit separate product feeds containing each condition type: "New", "Used", "Refurbished", and "Collectible". Ensure detail pages are appropriately updated.
  2. Submit separate product feeds containing "Like New," "Very Good," and "Good" for products that use the "Used" and "Collectible" condition type. Ensure product detail pages are appropriately updated.
  3. Submit separate product feeds containing "Like New," "Very Good," and "Good" for products that use the "New" and "Refurbished" condition type. Ensure product detail pages are not updated with these values.
  4. Submit multiple condition types per product. Verify that this operation succeeds.

A condition type is the way for sellers to list and classify items that are new, used, collectible, or refurbished. To include a condition type for a product, add the Condition element in the product feed. If you use text files, you also add condition information.

Note: The integration processes discussed in this topic do not apply to Books, Music, Video and DVD (BMVD) products. For more information, see Upload products using the Inventory Loader template and File Formats for BMVD.

Condition Types

The following Condition Types are available, depending on product category. The Used and Collectible condition types specify the exact description of the condition, as shown in the following table.

Note: Condition types are case-sensitive. "New" is not the same as "new." Definitions are also case-sensitive.

Table 1. Condition types
Element Description Data definition
New A brand-new, unused item in perfect condition. Optional field. Acceptable value is:

New.

Refurbished A product that is professionally restored to working order. Typically, this means the product is inspected, cleaned, and repaired to meet manufacturer specifications. The product might not be in its original packaging. The manufacturer warranty or warranty of the company performing the refurbishing services might apply to the product and should be included in the "Condition comments".

Optional field. Acceptable value is:

Refurbished.

Used A used item may be fairly worn or in perfect condition, but must still work perfectly.

Optional field. Acceptable value is:

Used.

Must be combined with a subtype.

Collectible Collectible items should be rare, signed, out of print/distribution, or otherwise unique--you can describe how your copy is collectible.

Optional field. Acceptable value is:

Collectible

Must be combined with a subtype.

Table 2. Condition types (cont.)
Element Description Data definition
Like New An apparently untouched product, in perfect condition. The original plastic wrap might be missing, but the original packaging is intact and pristine, and instructions are included. There are absolutely no signs of wear. Suitable for presenting as a gift. Optional field. Must be combined with appropriate condition type:

UsedLikeNew

CollectibleLikeNew

Very Good A well-cared-for product with limited use but still in great condition. The product is complete, unmarked, and undamaged, but might show some limited signs of wear. The product works perfectly. Optional field. Must be combined with appropriate condition type:

UsedVeryGood

CollectibleVeryGood

Good The product shows wear from consistent use, but remains in good condition. The product might be marked or have identifying information it, and show other signs of previous use. The product works perfectly. Optional field. Must be combined with appropriate condition type:

UsedGood

CollectibleGood

Acceptable The product is fairly worn, but it continues to work perfectly. The signs of wear can include scratches, dents, and other aesthetic problems. The product might be marked or have identifying information it, and show other signs of previous use. Optional field. Must be combined with appropriate condition type:

UsedAcceptable

CollectibleAcceptable

Product Feed Message Example

<Product> 
<SKU>ABC123SKU</SKU> 
<StandardProductID> 
<Type>ASIN</Type> 
<Value>B000000000</Value> 
</StandardProductID> 
<LaunchDate>11-11-2003H09:30:47-05:00</LaunchDate> 
<Condition> 
<ConditionType>UsedLikeNew</ConditionType> 
</Condition> 
</Product>

Testing Condition Types

To test text file and XML implementations, do the following:

  1. Submit separate product feeds containing each condition type: "New", "Used", "Refurbished", and "Collectible". Ensure detail pages are updated appropriately.
  2. Submit separate product feeds containing "Like New," "Very Good," and "Good" for products that use the "Used" and "Collectible" condition type. Ensure product detail pages are updated appropriately.
  3. Submit separate product feeds containing "Like New," "Very Good," and "Good" for products that use the "New" and "Refurbished" condition type. Ensure product detail pages are updated with these values.
  4. Submit multiple condition types per product. Verify that this operation succeeds.

For more information about including a product's condition, see the Condition guidelines.

A condition type is the way for sellers to list and classify items that are new, used, collectible, or refurbished. To include a condition type for a product, add the Condition element in the product feed. If you use text files, you also add condition information.

Note: The integration processes discussed in this topic do not apply to Books, Music, Video and DVD (BMVD) products. For more information, see Upload products using the Inventory Loader template and File Formats for BMVD.

Condition Types

The following Condition Types are available, depending on product category. The Used and Collectible condition types specify the exact description of the condition, as shown in the following table.

Note: Condition types are case-sensitive. "New" is not the same as "new." Definitions are also case-sensitive.

Table 1. Condition types
Element Description Data definition
New A brand-new, unused item in perfect condition. Optional field. Acceptable value is:

New.

Refurbished A product that is professionally restored to working order. Typically, this means the product is inspected, cleaned, and repaired to meet manufacturer specifications. The product might not be in its original packaging. The manufacturer warranty or warranty of the company performing the refurbishing services might apply to the product and should be included in the "Condition comments".

Optional field. Acceptable value is:

Refurbished.

Used A used item may be fairly worn or in perfect condition, but must still work perfectly.

Optional field. Acceptable value is:

Used.

Must be combined with a subtype.

Collectible Collectible items should be rare, signed, out of print/distribution, or otherwise unique--you can describe how your copy is collectible.

Optional field. Acceptable value is:

Collectible

Must be combined with a subtype.

Table 2. Condition types (cont.)
Element Description Data definition
Like New An apparently untouched product, in perfect condition. The original plastic wrap might be missing, but the original packaging is intact and pristine, and instructions are included. There are absolutely no signs of wear. Suitable for presenting as a gift. Optional field. Must be combined with appropriate condition type:

UsedLikeNew

CollectibleLikeNew

Very Good A well-cared-for product with limited use but still in great condition. The product is complete, unmarked, and undamaged, but might show some limited signs of wear. The product works perfectly. Optional field. Must be combined with appropriate condition type:

UsedVeryGood

CollectibleVeryGood

Good The product shows wear from consistent use, but remains in good condition. The product might be marked or have identifying information it, and show other signs of previous use. The product works perfectly. Optional field. Must be combined with appropriate condition type:

UsedGood

CollectibleGood

Acceptable The product is fairly worn, but it continues to work perfectly. The signs of wear can include scratches, dents, and other aesthetic problems. The product might be marked or have identifying information it, and show other signs of previous use. Optional field. Must be combined with appropriate condition type:

UsedAcceptable

CollectibleAcceptable

Product Feed Message Example

<Product> 
<SKU>ABC123SKU</SKU> 
<StandardProductID> 
<Type>ASIN</Type> 
<Value>B000000000</Value> 
</StandardProductID> 
<LaunchDate>11-11-2003H09:30:47-05:00</LaunchDate> 
<Condition> 
<ConditionType>UsedLikeNew</ConditionType> 
</Condition> 
</Product>

Testing Condition Types

To test text file and XML implementations, do the following:

  1. Submit separate product feeds containing each condition type: "New", "Used", "Refurbished", and "Collectible". Ensure detail pages are updated appropriately.
  2. Submit separate product feeds containing "Like New," "Very Good," and "Good" for products that use the "Used" and "Collectible" condition type. Ensure product detail pages are updated appropriately.
  3. Submit separate product feeds containing "Like New," "Very Good," and "Good" for products that use the "New" and "Refurbished" condition type. Ensure product detail pages are updated with these values.
  4. Submit multiple condition types per product. Verify that this operation succeeds.

For more information about including a product's condition, see the Condition guidelines.
Sign in to use the tool and get personalized help (desktop browser required). Sign in


Reach Hundreds of Millions of Customers

Start Selling On Amazon


© 1999-2020, Amazon.com, Inc. or its affiliates