/wix-manage

CMS eCommerce Catalog Integration

This recipe documents how to convert CMS collections into sellable product catalogs that integrate with Wix eCommerce (cart, checkout, orders).

Overview

Converting a CMS collection to a catalog enables:

• Items in the collection become purchasable products
• Integration with the Wix Cart API (Cart V2, which unifies cart and checkout)
• Real-time price and availability from your CMS data

Prerequisites

Your collection needs these fields (or mappable equivalents):

• Name field (TEXT) - Product display name
• Price field (NUMBER) - Product price

Optional catalog fields:

• Description (TEXT) - Product description
• Image (IMAGE) - Product image
• URL (URL) - Product link
• Quantity (NUMBER) - Inventory quantity

Step 1: Add CATALOG Plugin to Collection

API Endpoint

POST https://www.wixapis.com/wix-data/v2/collections/add-plugin

Example: Convert Collection with Custom Field Names

{
  "dataCollectionId": "Products",
  "plugin": {
    "type": "CATALOG",
    "catalogOptions": {
      "name": "title",
      "price": "price",
      "description": "description"
    }
  }
}

Example: Full Catalog with All Optional Fields

{
  "dataCollectionId": "Products",
  "plugin": {
    "type": "CATALOG",
    "catalogOptions": {
      "name": "itemName",
      "price": "itemPrice",
      "description": "itemDescription",
      "image": "itemImage",
      "url": "itemUrl",
      "quantity": "itemQuantity"
    }
  }
}

Step 2: Verify eCommerce App is Installed

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/v2/carts

Step 3: Use Catalog Items in Cart

CMS App ID (for catalogReference)

e593b0bd-b783-45b8-97c2-873d42aacaf4

Add CMS Catalog Item to Cart

POST https://www.wixapis.com/ecom/v2/carts/{cartId}/add-line-items

{
  "catalogItems": [
    {
      "catalogReference": {
        "appId": "e593b0bd-b783-45b8-97c2-873d42aacaf4",
        "catalogItemId": "<cms-item-id>"
      },
      "quantity": 1
    }
  ]
}

Removing CATALOG Plugin

POST https://www.wixapis.com/wix-data/v2/collections/delete-plugin

{
  "dataCollectionId": "Products",
  "pluginType": "CATALOG"
}

Differences from Wix Stores

CMS Catalogs are best for simple product catalogs. For complex eCommerce needs, consider Wix Stores.

See Also

• CMS Schema Management
• CMS Data Operations
• Wix Cart API