How do I provide unit price for my products?

To help merchants comply with applicable laws requiring price per unit of measurement to be displayed for products sold to or within the European Union, United Kingdom, and United States, merchants may now provide various unit price-related product attributes when adding/editing products manually or via CSV in Merchant Dashboard, or via API. These product attributes will be used to calculate and display unit price to customers on the Wish app and wish.com. Adding unit price attributes in order to display unit price is strongly encouraged for (but not limited to) products categorized as cleaning supplies, toiletries, beauty, cosmetics, personal care, and other product types sold in quantities or measurements.  

See below for more information on unit price, including how to provide unit price product attributes when adding/editing products manually or via CSV in Merchant Dashboard, or via API.

1. What are the unit price product attributes?

See below for a list of all unit price product attributes. These product attributes will be used to calculate and display unit price:

• Measured yype: The type of measurement.
  • Weight
  • Volume US imperial
  • Volume metric
  • Length
  • Area
  • Per unit
• Unit: 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.
  • 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
• Quantity value: 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, merchants will need to set quantity values for each product variant.
• Reference value: 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. 

2. How are the unit price product attributes used to calculate and display unit price?

The above-listed unit price product attributes will be used to calculate and display unit price, using the following formula:

(Price * Reference Value) / Quantity Value = Unit Price (displayed per Reference Value in given Unit)

See below for a few examples illustrating the calculation of unit price:

a. Merchant A is listing a 210 fl ounce ‘140 Loads’ liquid laundry detergent for $11.69 and would like to display the price per load:

• Measured Type = Per unit
• Unit = load
• Quantity value = 140
• Reference value = 1
• Unit price = ($11.69 * 1) / 140 = $0.08 per 1 load

b. Merchant B is 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

3. Where will unit price be displayed?

Unit price for applicable products will be displayed to customers on product listing pages in the Wish app and wish.com.

4. How can I set unit price product attributes for my products?

See below for a walkthrough of how to set unit price product attributes when adding/editing products manually or via CSV in Merchant Dashboard, or via API.

Manually via Merchant Dashboard

When adding new products via Products > Add New Product, navigate to the Unit price (optional) section. Here, merchants can provide Measured type (drop-down selection), Unit, and Reference value. In the Variations (optional) section below, merchants can provide Quantity value per product variation.

When editing products in the Edit Listing page via Products > View All Products, merchants may navigate to the same Unit price (optional) section. Merchants may check the Show unit price for this product checkbox, select Measured type and Unit, and provide a Reference value. Under the Variations(option) section below, merchants can provide Quantity value per product variation as well.

CSV Upload via Merchant Dashboard

When adding/editing products via CSV in Merchant Dashboard, merchants may upload a product CSV file with the attributes Unit, Reference value, and Quantity value.

For more information on adding/editing products via CSV in Merchant Dashboard, please see this guide. 

For more information on required and optional product CSV attributes, including attributes that have recently been renamed, please see this guide.

Via API

Merchants may now use ‘unit’, ‘reference_value’, and ‘quantity_value’ as inputs in the following Products v3 API endpoints:

POST /api/v3/products

PUT /api/v3/products/{id}

Merchants will now see ‘unit’, ‘reference_value’, and ‘quantity_value’ as fields for applicable products in the response schema of the following Products v3 API endpoint:

GET /api/v3/products/{id}