Setting the file. One moment.
Subchapter 8.25
references/cms/cms-ecommerce-catalog-integration.mdMarkdown3 KBView on GitHub
This recipe documents how to convert CMS collections into sellable product catalogs that integrate with Wix eCommerce (cart, checkout, orders).
Converting a CMS collection to a catalog enables:
Your collection needs these fields (or mappable equivalents):
Optional catalog fields:
POST https://www.wixapis.com/wix-data/v2/collections/add-plugin{
"dataCollectionId": "Products",
"plugin": {
"type": "CATALOG",
"catalogOptions": {
"name": "title",
"price": "price",
"description": "description"
}
}
}{
"dataCollectionId": "Products",
"plugin": {
"type": "CATALOG",
"catalogOptions": {
"name": "itemName",
"price": "itemPrice",
"description": "itemDescription",
"image": "itemImage",
"url": "itemUrl",
"quantity": "itemQuantity"
}
}
}Most Wix sites with Stores, Bookings, or similar apps already have eCommerce installed. Check by querying the Cart API:
POST https://www.wixapis.com/ecom/v1/cartse593b0bd-b783-45b8-97c2-873d42aacaf4POST https://www.wixapis.com/ecom/v1/carts/{cartId}/add-to-cart{
"lineItems": [
{
"catalogReference": {
"appId": "e593b0bd-b783-45b8-97c2-873d42aacaf4",
"catalogItemId": "<cms-item-id>"
},
"quantity": 1
}
]
}POST https://www.wixapis.com/wix-data/v2/collections/delete-plugin{
"dataCollectionId": "Products",
"pluginType": "CATALOG"
}| Feature | CMS Catalog | Wix Stores |
|---|---|---|
| Product management | CMS collections | Stores dashboard |
| Variants | Manual (separate items) | Built-in variant system |
| Inventory tracking | Manual via quantity field | Automatic |
| Product options | Not supported | Full support |
| Discounts | Manual price changes | Built-in discount system |
CMS Catalogs are best for simple product catalogs. For complex eCommerce needs, consider Wix Stores.