> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# Resource: Products

# Type: Product Object

# Link: https://dev.wix.com/docs/api-reference/business-solutions/suppliers-hub/products/product-object.md

## Description: A product provided by a business partner and displayed in the Wix Marketplace.

Products can be of type DROPSHIPPING, WHOLESALE, or both.
Wix users can discover and add these products to their stores.

## Schema:

```json
 Type: Product Object | type: Product
 Description: A product provided by a business partner and displayed in the Wix Marketplace.

Products can be of type DROPSHIPPING, WHOLESALE, or both.
Wix users can discover and add these products to their stores.
       - name: id  | type: string | description: Product ID.
           - name: value  | type: string | description: 
       - name: createdDate  | type: string | description: Date and time the product was created.
           - name: seconds  | type: string | description: 
           - name: nanos  | type: number | description: 
       - name: updatedDate  | type: string | description: Date and time the product was updated.
       - name: providerInfo  | type: ProviderInfo | description: Information about the business partner providing this product.
           - name: appId  | type: string | description: Provider application ID.
           - name: productId  | type: string | description: Unique product identifier on the provider's platform.  This field serves as the external system's primary key for synchronization and prevents duplicate products from being created. Once set, you can't change this field.
           - name: productCreatedDate  | type: string | description: Date and time the product was created on the provider's platform.  This field helps maintain the connection to the original product source. Once set, you can't change this field.
           - name: url  | type: string | description: Product URL on the provider's platform.
       - name: name  | type: string | description: Product name.
       - name: description  | type: string | description: Product description.
       - name: visible  | type: boolean | description: Whether the product is visible in the Marketplace.  Default: `true`
           - name: value  | type: boolean | description: 
       - name: media  | type: Media | description: Product media.
           - name: main  | type: Image | description: Primary product image, automatically set from the first item in the `items` array.
               - name: id  | type: string | description: WixMedia image ID.
               - name: url  | type: string | description: Image URL.
               - name: height  | type: number | description: Original image height.
               - name: width  | type: number | description: Original image width.
               - name: altText  | type: string | description: Image alt text.
               - name: filename  | type: string | description: Image filename.
           - name: items  | type: Array<Image> | description: Product images. The first image becomes the main image.
       - name: types  | type: Array<ProductType> | description: Business model types this product supports.
           enum: DROPSHIPPING, WHOLESALE, PRINT_ON_DEMAND
       - name: options  | type: Array<ProductOption> | description: Product options that customers can choose from.  Options display available product variations like size and color to help buyers make purchase decisions. Currently, options are informational only and don't create separate inventory items or variants.  There are 2 predefined option types you can use: - `color`: Color choices for the product. Values should be standard color names. For example, `"Black"`, `"White"`, `"Yellow"`. - `size`: Size choices for the product. Values should be standard size labels. For example, `"S"`, `"M"`, `"L"`, `"XL"`.
           - name: name  | type: string | description: Option name.  There are 2 predefined options you can use: - `color`: Represents color choices for the product. Values should be standard color names. For example, `"Black"`, `"White"`, `"Yellow"`. - `size`: Represents size choices for the product. Values should be standard size labels. For example, `"S"`, `"M"`, `"L"`, `"XL"`.
           - name: description  | type: string | description: Optional description explaining the option.
           - name: values  | type: Array<OptionValue> | description: Available values for this option.
       - name: ribbonName  | type: string | description: Promotional ribbon text displayed on the product.  For example, `"New Arrival"` or `"Bestseller"`.
       - name: brand  | type: string | description: Brand name.
       - name: orderProcessingTime  | type: TimeInterval | description: Time required to process orders before shipping.
           - name: min  | type: TimeValue | description: Minimum time in the range.
               - name: value  | type: number | description: Numeric time value. For example, `2` for "2 days".
               - name: unit  | type: string | description: Time unit for the value.
           - name: max  | type: TimeValue | description: Maximum time in the range.
       - name: shippingDestinations  | type: Array<ShippingDestination> | description: Countries and regions where this product can be shipped, with location-specific pricing and timing.
           - name: countrySelections  | type: string | description: Indicates if shipping applies to selected countries or to all other regions.
               enum: REST_OF_THE_WORLD, SPECIFIC_COUNTRY
           - name: minimumShippingCost  | type: string | description: Minimum shipping cost to this destination in USD.
           - name: shippingTime  | type: TimeInterval | description: Expected shipping time to this destination.
           - name: minimumProductCost  | type: string | description: Minimum Product Cost to the Shipping Location
       - name: minimumPrice  | type: string | description: Minimum price, in USD.
       - name: productOrigin  | type: string | description: Country where the product is manufactured or originates from, in [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format.
       - name: directCategories  | type: Array<ProductCategory> | description: List of categories that directly contain this product.  Each category's namespace must match at least one of the product's types. For example, if a product has type `DROPSHIPPING`, its categories must use `DROPSHIPPING_NAMESPACE`. Products with both `DROPSHIPPING` and `WHOLESALE` types can have categories from both namespaces.
           - name: id  | type: string | description: Category ID.
           - name: index  | type: number | description: Product's position within this category.
               - name: value  | type: number | description: 
           - name: namespace  | type: string | description: The namespace of the category tree this assignment belongs to.
               enum: DROPSHIPPING_NAMESPACE, WHOLESALE_NAMESPACE, PRINT_ON_DEMAND_NAMESPACE
       - name: allCategories  | type: Array<ProductCategory> | description: List of categories that directly contain this product, as well as their parent categories.
       - name: wholesaleOptions  | type: WholesaleOptions | description: Wholesale-specific configuration including tiered pricing and minimum order quantities.  Required when `types` includes `WHOLESALE`.
           - name: priceTiers  | type: Array<PriceTier> | description: Tiered pricing based on order quantity ranges.  Price tiers must be continuous with no gaps in quantity ranges. For example, if tier 1 covers quantities 1-100, tier 2 must start at 101. The system validates tier continuity when creating or updating products.
               - name: priceFrom  | type: string | description: Minimum price for this quantity tier in USD.  If `priceTo` isn't specified, this price applies to all quantities in the tier.
               - name: priceTo  | type: string | description: Maximum price for this quantity tier in USD.  Optional for fixed-price tiers.
               - name: countFrom  | type: number | description: Minimum quantity for this price tier, inclusive.
               - name: countTo  | type: number | description: Maximum quantity for this price tier, inclusive.  If not specified, this tier applies to all quantities greater or equal to `countFrom`.
           - name: minimumOrderQuantity  | type: number | description: Minimum quantity required for wholesale orders.
       - name: supplierInfo  | type: SupplierInfo | description: Information about the supplier including name, rating, and trust status.
           - name: id  | type: string | description: Supplier ID.  When provided, references a supplier in the Marketplace Supplier service. The system automatically retrieves and populates the supplier's name, rating, and verification status.
           - name: name  | type: string | description: Supplier name.  Automatically populated from the Supplier service when `id` is provided.
           - name: rating  | type: string | description: Supplier rating from 1.00 to 5.00.  Automatically populated from the Supplier service when `id` is provided.
           - name: verified  | type: boolean | description: Whether the supplier has been verified by the Marketplace.  Verified suppliers have completed the Marketplace verification process. Automatically populated from the Supplier service when `id` is provided.  Default: `false`
       - name: printOnDemandOptions  | type: PrintOnDemandOptions | description: Print-on-demand-specific configuration including supported print technologies and mockup assets.  Required when `types` include `PRINT_ON_DEMAND`.
           - name: printTechnologies  | type: Array<PrintTechnology> | description: Set of possible print technologies for the Product
               enum: DIRECT_TO_FILM, DIRECT_TO_GARMENT, CUT_SEW_SUBLIMATION, DIGITAL_PRINTING, EMBROIDERY, SUBLIMATION, UV_PRINTING, KNITWEAR, DIRECT_TO_FABRIC
           - name: mockupImage  | type: Image | description: Mockup image of the product with 'Your Image Here' text.
       - name: sizeGuides  | type: Array<SizeGuide> | description: Information about the product sizing
           - name: measurementUnit  | type: string | description: Sizes units (inches or cm)
               enum: CM, INCHES
           - name: description  | type: string | description: Text description of the size guide
           - name: imageUrl  | type: string | description: Image for the size guide
           - name: imageDescription  | type: string | description: Text description of the image content
           - name: specifications  | type: Array<Specification> | description: Sizes specifications
               - name: category  | type: string | description: What is measured, e.g. chest, waist, sleeve
               - name: measurements  | type: Array<Measurement> | description: Measurements for different sizes
       - name: tags  | type: Tags | description: Product tags for organization and filtering.
           - name: privateTags  | type: TagList | description: Tags that require an additional permission in order to access them, normally not given to site members or visitors.
               - name: tagIds  | type: Array<string> | description: List of tag IDs.
           - name: publicTags  | type: TagList | description: Tags that are exposed to anyone who has access to the labeled entity itself, including site members and visitors.

```