As part of our recently revamped manual add product experience and product CSV upload experience, we have compiled a list of all required and optional product attributes for adding products (with descriptions and examples). Please be aware that several product attributes have been renamed, which will be indicated below.
Required Attributes:
It is necessary to include certain product attributes when adding products manually via Merchant Dashboard, via CSV, or via API. For merchants adding or editing products via CSV, please see below for a table of required attributes depending on your desired action:
See below for a description of required attributes when adding products manually via Merchant Dashboard, via CSV, or via API:
Parent SKU
Type: String
When defining a variation of a product, we must know which product to attach the variation(s). 'Parent SKU' is the 'SKU' of the product you wish to attach this variant. The 'Parent SKU' must already exist on Wish or be included elsewhere in your upload.
Examples:
- Acceptable: HSC0424PP
- Acceptable: 112123343455432
- Unacceptable: 2
- Unacceptable: a
SKU
Type: String
Provide the unique SKU number you use internally to identify this item. Please keep this SKU number for any SKU number updates to this item in future feeds. Wish.com's system uses this SKU number to identify, track, update, and report on this item.
Examples:
- Acceptable: HSC0424PP
- Acceptable: 112123343455432
- Unacceptable: 2
- Unacceptable: a
Name
Type: String
Use the following template to build your product names: Main brand + Sub-brand, family or product name + Up to 3 key attributes + Generic product type. Names must be clear and concise and should also be descriptive of the product being sold. This template will help customers identify your product.
Examples:
- Acceptable: Nikon D5100 DSLR Camera (Body Only) USA MODEL
- Acceptable: Sony VAIO 15" Laptop
- Unacceptable: Best Price!!! ***CHEAP*** Baby Stroller!!!
Description
Type: String
A detailed description of your product. Limit of 4,000 characters, and only the first 250 characters are displayed on the initial search page. Do not include any HTML code, details about store policies, other store-specific language or multiple lines. 'New line' characters (such as 'enter' or 'return') will cause problems with your file. Information about size, fit, and measurements is helpful for apparel items.
Examples:
- Acceptable: This dress shirt is 100% cotton and fits true to size.
- Unacceptable: This <b>dress shirt</b> is 100% cotton and <i>fits true to size</i>.
Main Image (previously Main Image URL)
Type: URL
URL of a photo of your product. Link directly to the image, not the page where it is located. We accept JPEG or GIF format. Do not include company logos or names or promotional or other identifying text. Images should be at least 100 x 100 pixels in size. Do not include any "image not found" images. We do not accept image URLs that begin with https://.
Examples:
- Acceptable: http://www.yourwebsite.com/images/7324204/3
- Acceptable: http://www.yourwebsite.com/images/dress.jpg
- Unacceptable: https://www.your website.com/images/7324204/3
- Unacceptable: http://www.yourwebsite.com/images/dresses.html
Currency Code (previously Local Currency Code)
Type: String
Your local currency code, the currency used for all of your products. This must match your localized currency.
Examples:
- Acceptable: USD
- Acceptable: CNY
- Unacceptable: Chinese
Price
Type: Price
The local currency price of your product. The customer will pay this amount for the product after the prices have been converted to your currency. The local currency price is based on the local currency code that can be found under Currency Settings or via API GET /api/v3/merchant/currency_settings.
Examples:
- Acceptable: 100.99
- Acceptable: 10.99
- Unacceptable: 49.99 + S/H
Default Shipping Price (previously Shipping)
Type: Object
The default shipping price of your product. This will automatically apply as the shipping price for any new or unset countries in this warehouse.
Examples:
- Acceptable: 100.99
- Acceptable: 10.99
- Unacceptable: 49.99 + S/H
Inventory (previously Quantity)
Type: Integer
Amount of an SKU that is in stock. Please use inventory buffering for Wish specified inventory. Maximum 500,000. Larger inventories will be automatically lowered.
Examples:
- Acceptable: 1200
- Acceptable: 0
- Acceptable: 4
- Unacceptable: In stock
- Unacceptable: Out of Stock
Warehouse
Type: String
Provide the unique warehouse name you use internally to identify a warehouse. Shipping price, and inventory are applied to the specified warehouse only. If you do not define one, they are applied to the default warehouse attached to your account.
Examples:
- Acceptable: US_94132
- Acceptable: SZ_CN
- Unacceptable: 2
- Unacceptable: a
Optional Attributes:
See below for a list and description of optional attributes when adding products manually via Merchant Dashboard, via CSV, or via API.
Extra Images (previously Extra Image(s))
Type: String
List of URLs of images of the product, separated by '|'. Link directly to the image, not the page where it is located. Same rules apply as the Main Image URL attribute. The order of the URLs will be the order of the images displayed on the product page. To update existing images or add new images, you need to provide all extra image URLs, including the ones that remain the same. If none of the extra image URLs are provided, no update will be done. Provide REMOVE_ALL to unset all existing extra images. Images can be in JPEG, PNG or GIF format. Images should be at least 100 x 100 pixels in size.
Examples:
- Acceptable: http://www.yourwebsite.com/images/7324204/3 | https://www.yourwebsite.com/images/dress.jpg
- Acceptable: http://www.yourwebsite.com/images/dress.jpg
- Acceptable: REMOVE_ALL
- Unacceptable: https://www.your website.com/images/7324204/3
- Unacceptable: http://www.yourwebsite.com/images/dresses.html
Variation Image
Type: String
URL of a photo of your product. Link directly to the image, not the page where it is located. We accept JPEG, PNG or GIF format. Do not include company logos or names or promotional or other identifying text. Images should be at least 100 x 100 pixels in size. Do not include any "image not found" images. We do not accept image URLs that begin with https://.
Examples:
- Acceptable: http://www.yourwebsite.com/images/7324204/3
- Acceptable: http://www.yourwebsite.com/images/dress.jpg
- Acceptable: REMOVE_ALL
- Unacceptable: https://www.your website.com/images/7324204/3
- Unacceptable: http://www.yourwebsite.com/images/dresses.html
Clean Image
Type: String
URL of the Clean Image of your product. Must be the same Wish URL as the Main Image URL or one of the existing Extra Image URLs or the url of a new added image. Products with a Clean Image selected may receive increased impressions and sales. Learn more.
Examples:
- Acceptable: http://www.yourwebsite.com/images/7324204/3
- Acceptable: http://www.yourwebsite.com/images/dress.jpg
- Unacceptable: https://www.your website.com/images/7324204/3
- Unacceptable: http://www.yourwebsite.com/images/dresses.html
Video URL
Type: String
URL of the demo video that was uploaded for this product. Learn more.
Examples:
- Acceptable: http://www.yourwebsite.com/videos/demo.mp4
- Unacceptable: https://www.youtube.com/watch?v=123465789
- Unacceptable: http://www.yourwebsite.com/video/dresses.html
Brand ID
Type: String
Provide the product brand ID of the product being sold.
The product must be authentic and directly manufactured by the brand owner. For example, Apple is the Brand of iPhone or iPad but Apple is not the Brand of an iPhone case not manufactured by Apple.
Visit Brand Directory to view a list of brands to select from or request a new brand to be added.
Examples:
- Acceptable: 545d5e6a6fa88c38cdfe0735
GTIN (previously UPC)
Type: String
12 to 14 digits GTIN (UPC, EAN, ISBN) that contains no letters or other characters. A barcode symbology used for tracking trade items in stores and scanning them at the point of sale.
Examples:
- Acceptable: 716393133224
- Unacceptable: asdf884445ds
Reference Price (previously MSRP)
Type: String
Listings include a field for a comparison or reference price. Merchants are not required to provide a value for Reference Price. If merchants choose to provide a value for Reference Price, each Reference Price must comply with the Product Reference Price Policy. To learn more, click here.
Examples:
- Acceptable: 716393133224
- Unacceptable: asdf884445ds
Color
Type: String
The color of the product, especially as it pertains to apparel or jewelry. Each color variation must be its own row in the feed, have its own unique SKU, and its own inventory level. If you would like to have it show two colors, simply separate the colors by "&" (e.g., black & red). Please note that showing two colors here should not to be confused with products having two different colored variations. The name of the color must be in the list of currently accepted colors.
Examples:
- Acceptable: red
- Acceptable: black & blue
- Unacceptable: red, blue
- Unacceptable: black & blue & green
Size
Type: String
The size of the product, especially as it pertains to apparel, footwear, or jewelry. Each size variation must be its own row in the feed, have its own unique SKU, and its own inventory level. It must be either a number or in the list of currently accepted sizes.
Examples:
- Acceptable: S
- Acceptable: XXL
- Acceptable: 6
- Acceptable: 6.5
- Unacceptable: small
- Unacceptable: S, M
Tags
Type: String
Non-hierarchical keyword or term assigned to each product in your feed. This kind of metadata helps describe an item and allows it to be categorized and found again by browsing or searching on Wish.com. Tags should be comma separated, but do NOT use commas in individual tags. The more tags you add, and the more accurate your tags, the better the chances our users will find your products. There is a maximum of 10 tags allowed per product, if you add more than 10 we ignore the extra tags.
Examples:
- Acceptable: Shirt, Men's Fashion, Navy, Blue, Casual, Apparel
- Acceptable: Women's Fashion, Jewelry & Watches
- Acceptable: Men's Fashion, Suits, Mafia, Silk Tie, Ties
- Unacceptable: Clearance Items
- Unacceptable: Cheap Cheap Cheap
- Unacceptable (Too many tags): Fashion, Suits, Ties, Silk Ties, Men's Suits, Italian Made Suits, Italian, Men's Fashion, Hand Crafted, Silk, High Quality
Enabled
Type: String
Enable this SKU on Wish. Users will be able to view and purchase the product.
Examples:
- Acceptable: 1
- Unacceptable: True
- Unacceptable: Enable
Disabled
Type: String
Disable this SKU on Wish. Users will not be able to view or purchase the product.
Examples:
- Acceptable: 1
- Unacceptable: True
- Unacceptable: Disable
Unit
Type: String
The unit of measurement for the total content of a product. This will be used to display the price per unit of a product (per the below formula), and is the unit of measurement that will be used for both the Reference Value and Quantity Value attributes.
(Price * Reference Value) / Quantity Value = Unit Price (displayed per Reference Value in given Unit)
As an example, you are listing a 200 milliliter bottle of perfume for $33.12 and would like to display the price per 100 milliliters:
- Measured Type = Volume metric
- Unit = milliliter
- Quantity value = 200
- Reference value = 100
- Unit Price = ($33.12 * 100) / 200 = $16.56 per 100 milliliters
For more information on unit price and setting unit price product attributes, please see this guide.
Examples:
- Weight: ounce, pound, gram, milligram, kilogram
- Volume US imperial: fluid_ounce, pint, quart, gallon
- Volume metric: milliliter, centiliter, liter, cubicmeter
- Length: inch, foot, yard, centimeter, meter
- Area: square_foot, square_meter
- Per unit: count, load, wash, roll, pod
Reference value
Type: Number <float>
The reference value (in the given unit) that is used to calculate the price per unit of a product and to illustrate the unit count for the consumer to see, using the below formula.
(Price * Reference Value) / Quantity Value = Unit Price (displayed per Reference Value in given Unit)
As an example, you are listing a 200 milliliter bottle of perfume for $33.12 and would like to display the price per 100 milliliter:
- Measured Type = Volume metric
- Unit = milliliter
- Quantity value = 200
- Reference value = 100
- Unit Price = ($33.12 * 100) / 200 = $16.56 per 100 milliliter
For more information on unit price and setting unit price product attributes, please see this guide.
Examples:
- Acceptable: 100
- Acceptable: 38
- Unacceptable: ABCXYZ
Quantity value
Type: Number <float>
The total quantity of the product variant (in the given unit) that is used to calculate the price per unit of a product, using the below formula. Note that if a product has multiple product variants, you will need to set quantity values for each product variant.
(Price * Reference Value) / Quantity Value = Unit Price (displayed per Reference Value in given Unit)
As an example, you are listing a 200mL bottle of perfume for $33.12 and would like to display the price per 100mL:
- Measured Type = Volume metric
- Unit = mL
- Quantity value = 200
- Reference value = 100
- Unit Price = ($33.12 * 100) / 200 = $16.56 per 100mL
For more information on unit price and setting unit price product attributes, please see this guide.
Examples:
- Acceptable: 1
- Acceptable: 15
- Unacceptable: ABCXYZ
Package Height
Type: Decimal
The height of the package in which your product will ship to the customer (Units in cm).
Examples:
- Acceptable: 13.40
Package Width
Type: Decimal
The width of the package in which your product will ship to the customer (Units in cm).
Examples:
- Acceptable: 13.40
Package Length
Type: Decimal
The length of the package in which your product will ship to the customer (Units in cm).
Examples:
- Acceptable: 10
Package Weight
Type: Decimal
The weight of the package in which your product will ship to the customer (Units in g).
Examples:
- Acceptable: 151.5
- Acceptable: 10
Pieces Included
Type: Integer
The amount of pieces that are associated with this item.
Examples:
- Acceptable: 2
- Acceptable: 1
- Unacceptable: -1
Contains Liquid
Type: Boolean
Whether the product contains liquid.
Examples:
- Acceptable: Yes
- Acceptable: No
- Unacceptable: 0
Contains Metal
Type: Boolean
Whether the product contains metal.
Examples:
- Acceptable: Yes
- Acceptable: No
- Unacceptable: 0
Contains Powder
Type: Boolean
Whether the product contains powder.
Examples:
- Acceptable: Yes
- Acceptable: No
- Unacceptable: 0
Contains Battery
Type: Boolean
Whether the product contains a battery/batteries.
Examples:
- Acceptable: Yes
- Acceptable: No
- Unacceptable: 0
Country of Origin
Type: String
Country where the product is manufactured. Country code should follow ISO 3166 Alpha-2 code.
Examples:
- Acceptable: CN
- Acceptable: US
- Unacceptable: China
Declared Name
Type: String
Declared name for logistics.
Examples:
- Acceptable: Repair Tools Kit Set
- Acceptable: Rings
- Unacceptable: !Rings
- Unacceptable: T
- Unacceptable: Good 衬衫
- Unacceptable: Name that is longer than 200 characters
Customs HS Code
Type: String
Harmonization System Code used for customs declaration.
Examples:
- Acceptable: 33021010.00
- Acceptable: 6403.20
- Unacceptable: 2
- Unacceptable: a
Customs Declared Value
Type: String
The price (in USD) of your product that will be declared to the customs.
Examples:
- Acceptable: $100.99
- Acceptable: 10.99
- Unacceptable: $49.99 + S/H
Max Quantity
Type: String
The maximum quantity of products per order. This lets users break down large orders for easy management and tracking. This should only be used in rare cases.
Examples:
- Acceptable: 100
- Acceptable: 10
- Acceptable: 1
- Unacceptable: 0
US TTD
Type: Integer
The specified time-to-door for the given country or region. Time-to-door is measured as the time from when the order was placed to when the order was confirmed delivered.If the delivery for this country is disabled, this column must also be set to 'disabled'. To update TDD for a different country/region use their 2 letter country code instead of US.
Examples:
- Acceptable: 4
- Unacceptable: one
- Unacceptable (over 15 days): 20
- Unacceptable (non-positive): -2
- Unacceptable (non-integer): 20.5
US
Type: Price
The localized country shipping price for customers that purchase in the United States. To update the localized shipping price for a different country use their 2 letter country code instead of US.
Examples:
- Acceptable: 1.99
- Unacceptable: 1.99+
- Acceptable: disabled
- Acceptable: enabled
US_HI
Type: Price
The regional shipping price for customers that purchase in Hawaii, United States. You can specify "disabled" or "enabled" to determine whether users in this region can buy the product. You can also specify "use country shipping price" to unset the regional shipping. To update the shipping price for a different region use their country code + '_' + region code defined here instead of US_HI.
Examples:
- Acceptable: 1.99
- Acceptable: disabled
- Acceptable: enabled
- Acceptable: use country shipping price
- Unacceptable: 1.99+
Condition
Type: String
Provide the condition of the product. You can choose “New," “Used," or “Refurbished." NOTE: Make sure to provide this information so that the product’s European Union-bound orders may smoothly pass through customs.
Examples:
- Acceptable: New
- Acceptable: Used
- Acceptable: Refurbished
- Unacceptable: Old
California Proposition 65 Warning Type
Type: String
Provide the warning type applicable to your product, if any, for compliance with California Proposition 65. You can choose “Chemical,” “Food,” “Furniture,” “On_Product_Cancer,” “On_Product_Combined_Cancer_Reproductive,” “On_Product_Reproductive,” “Raw_Wood,” or “Diesel_Engines.” For more information on California Proposition 65 compliance, please see the Help Center article, “California Proposition 65 overview and warning notices.”
Examples:
- Acceptable: Chemical
- Acceptable: Food
- Acceptable: On_Product_Cancer
- Unacceptable: Other
California Proposition 65 Chemical Names
Type: String
Provide the specific chemical name(s) applicable to your product, if any, for compliance with California Proposition 65. If you selected the Food, Furniture, or Chemical warning type (see previous attribute), you must provide at least one specific chemical name.
When using CSV, provide a list of chemical names, separated by '|'. You can provide up to a maximum of 5 chemical names. To see the full list of chemical names, please click here. For more information on California Proposition 65 compliance, please see the Help Center article, “California Proposition 65 overview and warning notices.”
Examples:
- Acceptable: Benzyl Chloride
- Acceptable: Lead
- Acceptable: Nalidixic Acid
- Unacceptable: Chemical
Comments
0 comments
Please sign in to leave a comment.