Product Object


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.

Properties
allCategoriesArray <ProductCategory>Read-onlymaxItems 2000

List of categories that directly contain this product, as well as their parent categories.


brandstringminLength 1maxLength 50

Brand name.


createdDatestringRead-onlyformat date-time

Date and time the product was created.


descriptionstringmaxLength 64000

Product description.


directCategoriesArray <ProductCategory>maxItems 50

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.


idstringRead-onlyformat GUID

Product ID.


inventoryInventoryInternal

[Out of scope of phase 1] Current inventory information including stock level tier.


mediaMedia

Product media.


minimumPricestringdecimalValue {"gte":"0","lte":"999999999","maxScale":3}

Minimum price, in USD.


namestringminLength 1maxLength 100

Product name.


optionsArray <ProductOption>maxItems 6

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".

orderProcessingTimeTimeInterval

Time required to process orders before shipping.


printOnDemandOptionsPrintOnDemandOptions

Print-on-demand-specific configuration including supported print technologies and mockup assets.

Required when types include PRINT_ON_DEMAND.


productOriginstringformat COUNTRY

Country where the product is manufactured or originates from, in ISO 3166-1 alpha-2 format.


providerInfoProviderInfo

Information about the business partner providing this product.


ribbonNamestringminLength 1maxLength 30

Promotional ribbon text displayed on the product.

For example, "New Arrival" or "Bestseller".


semanticProfileStruct

Automated semantic analysis results for product categorization and tagging.


shippingDestinationsArray <ShippingDestination>minItems 0maxItems 100

Countries and regions where this product can be shipped, with location-specific pricing and timing.


sizeGuidesArray <SizeGuide>minItems 0maxItems 5

Information about the product sizing


supplierInfoSupplierInfo

Information about the supplier including name, rating, and trust status.


tagsTags

Product tags for organization and filtering.


typesArray <string>minItems 1maxItems 2

Business model types this product supports.


updatedDatestringRead-onlyformat date-time

Date and time the product was updated.


visibleboolean

Whether the product is visible in the Marketplace.

Default: true


wholesaleOptionsWholesaleOptions

Wholesale-specific configuration including tiered pricing and minimum order quantities.

Required when types includes WHOLESALE.

Did this help?