About the Marketplace Products API

Use the Marketplace Products API to offer products in the Wix Marketplace as dropshipping, wholesale, or both. This API enables approved business partners to publish products to the Marketplace, where Wix users can discover and add them to their stores.

With the Marketplace Products API, you can:

• Create and manage products with rich media, pricing, and inventory information.
• Support both dropshipping and wholesale business models with flexible pricing tiers.
• Organize products using category assignment and tagging.
• Perform bulk operations for efficient catalog management.
• Search and query products with full-text search or real-time accuracy.

Applying for partnership

This API is available only to approved Wix business partners and requires a signed business agreement with Wix. To apply for partnership, contact suppliershub@wix.com with a short description of your product and integration goals.

Access to this API is limited to ensure that integrations meet Wix's product quality, data security, and user experience standards. Each request is reviewed individually based on the partner's product characteristics, technical capabilities, and alignment with Wix's ecosystem.

If your application does not meet the criteria for partnership, consider publishing your integration via the Wix App Market, which provides a public route for developers to make their products available to Wix users.

How it works

As a business partner, you create a provider app that manages products on behalf of one or more suppliers. Here's how the components work together:

1. Your Provider App: Integrates with the Marketplace Products API to create and manage product catalogs.
2. Suppliers: The actual businesses that own and fulfill the products. Each product can optionally be associated with a supplier to display supplier information like name, rating, and verification status in the Marketplace.
3. Products: The items you publish to the Marketplace. Each product must include core information like name, media, pricing, and business model type for either dropshipping, wholesale, or both.
4. Wix Store Owners: Browse the Marketplace, discover your products, and add them to their stores.

Your provider app serves as the connection point between your suppliers' product catalogs and the Wix Marketplace. You maintain synchronization by linking each Marketplace product to its source using providerInfo.productId.

Business models

The Marketplace supports 2 business models, and products can support one or both:

Dropshipping: Store owners add your products to their stores without holding inventory. When a customer places an order, the supplier ships directly to the customer. Dropshipping products require minimumPrice, shipping information, and dropshippingOptions.

Wholesale: Store owners purchase products in bulk at volume-based pricing tiers. Wholesale products require wholesaleOptions with:

• Price tiers: Quantity-based pricing that must be continuous, with no gaps between tiers. For example, tier 1 for quantities 1-100, tier 2 for 101+.
• Minimum order quantity: The smallest quantity a store owner can purchase.

Products can support both models simultaneously by setting types to both DROPSHIPPING and WHOLESALE. This allows store owners to choose their preferred business model for each product.

Inventory

Products include an inventory field with two values: inventory.quantity (the total stock across all product variants) and inventory.tier, a coarse stock-level bucket derived from quantity. Use tier when you only need a low/medium/high signal — for example, to render badges or trigger restock alerts — without tracking exact counts.

Providers report stock by calling Update Product with inventory.quantity. inventory.tier is computed automatically using these thresholds:

Tier	Quantity
EMPTY	0
VERY_LOW	1–10
LOW	11–25
MEDIUM	26–50
HIGH	51–100
VERY_HIGH	101+

If inventory hasn't been reported yet, quantity is null and tier is UNKNOWN_INVENTORY_TIER.

A Product Updated webhook fires when tier transitions, with inventory.tier listed in the modified fields, so you can react to stock-level changes without polling.

Product options

Product options describe the variations a product comes in, such as size or color. Each option has a name and a list of values. All values within a single option must be the same type.

There are 2 predefined option types:

• color: Set values.color with a color name, an optional hex code, and an optional sortIndex. Use "Multicolor" for mixed colors, and omit hex in that case.
• size, and any other non-color option: Set values.text with a display name and an optional sortIndex. For example, "S", "M", or "L".

Use sortIndex to control the display order of an option's values. For best results, use contiguous numbers starting at 0 with no gaps. When you omit sortIndex, the client decides the order.

Options are currently informational only. They display available variations to help buyers make purchase decisions, but they don't create separate inventory items or variants.

Before you begin

It's important to note the following points before starting to code:

• Business partner agreement required: Access to this API requires a signed business agreement and implementation plan with Wix.
• Bulk operation limits: Maximum 100 products per bulk request and 100 products per query request. For operations on more than 100 products, split them into multiple batches.
• Product media: Limited to 15 images per product. The first image becomes the main image.
• Categories: Limited to 100 categories per product. Category namespaces must match the product's type, either dropshipping or wholesale.
• Immutable fields: You can't change providerInfo.productId and providerInfo.productCreatedDate after creating a product. These fields link to your external system and prevent duplicates.
• Product options: Options are currently informational only and don't create separate inventory items. Variant inventory tracking is planned for a future release.
• Search vs Query: Use Query Products for real-time accuracy in operational tasks. Use Search Products for product discovery and browsing with eventual consistency.
• Supplier association: Associating a product with a supplier is optional. When you provide supplierInfo.id, the system automatically retrieves the supplier's name, rating, and verification status.

Use cases

• Create and manage product catalogs.
• Organize products with categories and search for better discoverability.

Terminology

• Marketplace: The platform where suppliers publish products and Wix store owners discover them.
• Provider: A business partner app that manages products on behalf of suppliers. One provider can manage products for multiple suppliers.
• Supplier: The actual business entity that owns and fulfills the products.
• Dropshipping: A business model where suppliers fulfill orders directly to customers without Wix store owners handling inventory.
• Wholesale: A business model where Wix store owners purchase products in bulk at tiered pricing.
• Direct categories: Categories explicitly assigned to a product.
• All categories: All categories a product belongs to, including parent and ancestor categories.
• Price tier: Quantity-based pricing levels for wholesale products. Tiers must be continuous with no gaps.
• Verified supplier: A supplier that has completed the Marketplace verification process.