Skill

Product Management - Wix Stores API

Handles full CRUD operations on Wix Stores products including variants, media, collections, and bulk actions via direct REST API calls. Useful for managing ecommerce catalogs.

REST API

api-development

backend

npx claudepluginhub wix/wix-ecom-cowork --plugin wix-ecom-cowork

Popularity

Parent stars

Parent forks

Invocation

How this skill is triggered — by the user, by Claude, or both

Slash command

/wix-ecom-cowork:product-management

User invocable

Model invocable

Inline context

Default effort

Context Preview

The summary Claude sees in its skill listing — used to decide when to auto-load this skill

Complete product CRUD operations including variants, media, collections, and bulk operations using direct Wix REST API calls.

SKILL.md

753 lines · ~3.8k tokens

Similar Skills

wix-manage

Configures and manages Wix business solutions via REST API: stores, bookings, payments, CMS, contacts, events, forms, media, blog, calendar, domains, and more.

20 files

wix

Product Creation Workflow Guide - Best Practices

Guides optimal workflows and API sequences for creating complete products in Wix Stores, including preparation, categories, images, variants, inventory, SEO, and visibility settings.

wix-ecom-cowork

shopify-products

785

Creates and manages Shopify products via GraphQL Admin API or CSV imports. Bulk import/update variants, inventory, images, assign to collections.

1 file

shopify

Stats

LanguageJavaScript

Parent stars15

Parent forks1

MaintenanceFair

Last CommitMar 13, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

Stats

Actions

Help us improve

Share bugs, ideas, or general feedback.

Product Management - Wix Stores API

Overview

Complete product CRUD operations including variants, media, collections, and bulk operations using direct Wix REST API calls.

Configuration

App ID: df7c18eb-009b-4868-9891-15e19dddbe67
API Key: ${API_KEY}
Site ID: ${SITE_ID}

Query Products

Basic Query

Endpoint: POST https://www.wixapis.com/stores/v1/products/query

API Call:

curl -X POST "https://www.wixapis.com/stores/v1/products/query" \
  -H "Authorization: ${API_KEY}" \
  -H "wix-site-id: ${SITE_ID}" \
  -H "Content-Type: application/json" \
  -d '{
  "query": {
    "paging": {
      "limit": 50,
      "offset": 0
    }
  }
}'

Response:

{
  "products": [
    {
      "id": "abc123",
      "name": "Product Name",
      "description": "Product description",
      "price": 29.99,
      "visible": true,
      "productType": "physical",
      "stock": {
        "trackInventory": true,
        "inStock": true,
        "quantity": 100
      }
    }
  ],
  "metadata": {
    "count": 50,
    "offset": 0,
    "total": 234
  }
}

Query Visible Products Only

curl -X POST "https://www.wixapis.com/stores/v1/products/query" \
  -H "Authorization: ${API_KEY}" \
  -H "wix-site-id: ${SITE_ID}" \
  -H "Content-Type: application/json" \
  -d '{
  "query": {
    "filter": "{\"visible\": true}",
    "paging": {"limit": 100}
  }
}'

Query Products by Price Range

curl -X POST "https://www.wixapis.com/stores/v1/products/query" \
  -H "Authorization: ${API_KEY}" \
  -H "wix-site-id: ${SITE_ID}" \
  -H "Content-Type: application/json" \
  -d '{
  "query": {
    "filter": "{\"price\": {\"$gte\": 10, \"$lte\": 100}}",
    "sort": "{\"price\": \"asc\"}",
    "paging": {"limit": 50}
  }
}'

Query Products by Collection

curl -X POST "https://www.wixapis.com/stores/v1/products/query" \
  -H "Authorization: ${API_KEY}" \
  -H "wix-site-id: ${SITE_ID}" \
  -H "Content-Type: application/json" \
  -d '{
  "query": {
    "filter": "{\"collectionIds\": \"collection-abc123\"}",
    "paging": {"limit": 100}
  }
}'

Get Single Product

Endpoint: GET https://www.wixapis.com/stores/v1/products/{productId}

API Call:

curl -X GET "https://www.wixapis.com/stores/v1/products/${PRODUCT_ID}" \
  -H "Authorization: ${API_KEY}" \
  -H "wix-site-id: ${SITE_ID}" \
  -H "Accept: application/json"

Response:

{
  "product": {
    "id": "abc123",
    "name": "Product Name",
    "slug": "product-name",
    "visible": true,
    "productType": "physical",
    "description": "Full product description",
    "price": 29.99,
    "comparePrice": 39.99,
    "sku": "PROD-001",
    "weight": 1.5,
    "stock": {
      "trackInventory": true,
      "inStock": true,
      "quantity": 100
    },
    "media": {
      "mainMedia": {
        "image": {
          "url": "https://static.wixstatic.com/media/image.jpg",
          "altText": "Product image"
        }
      },
      "items": []
    },
    "customTextFields": [],
    "productOptions": [],
    "variants": []
  }
}

Create Product

Endpoint: POST https://www.wixapis.com/stores/v1/products

API Call:

curl -X POST "https://www.wixapis.com/stores/v1/products" \
  -H "Authorization: ${API_KEY}" \
  -H "wix-site-id: ${SITE_ID}" \
  -H "Content-Type: application/json" \
  -d '{
  "product": {
    "name": "New Product",
    "description": "Product description here",
    "priceData": {
      "price": 29.99
    },
    "productType": "physical",
    "visible": true,
    "stock": {
      "trackInventory": true,
      "quantity": 50
    }
  }
}'

Response:

{
  "product": {
    "id": "new-product-id-123",
    "name": "New Product",
    "slug": "new-product",
    "price": 29.99,
    "visible": true,
    "stock": {
      "trackInventory": true,
      "inStock": true,
      "quantity": 50
    }
  }
}

Update Product

Endpoint: PATCH https://www.wixapis.com/stores/v1/products/{productId}

Update Price and Visibility:

curl -X PATCH "https://www.wixapis.com/stores/v1/products/${PRODUCT_ID}" \
  -H "Authorization: ${API_KEY}" \
  -H "wix-site-id: ${SITE_ID}" \
  -H "Content-Type: application/json" \
  -d '{
  "product": {
    "price": 24.99,
    "comparePrice": 34.99,
    "visible": true
  }
}'

Update Description and SEO:

curl -X PATCH "https://www.wixapis.com/stores/v1/products/${PRODUCT_ID}" \
  -H "Authorization: ${API_KEY}" \
  -H "wix-site-id: ${SITE_ID}" \
  -H "Content-Type: application/json" \
  -d '{
  "product": {
    "description": "Updated product description",
    "seoData": {
      "tags": [
        {
          "type": "title",
          "children": "SEO Title",
          "custom": true
        },
        {
          "type": "meta",
          "props": {
            "name": "description",
            "content": "SEO description"
          }
        }
      ]
    }
  }
}'

Delete Product

Endpoint: DELETE https://www.wixapis.com/stores/v1/products/{productId}

API Call:

curl -X DELETE "https://www.wixapis.com/stores/v1/products/${PRODUCT_ID}" \
  -H "Authorization: ${API_KEY}" \
  -H "wix-site-id: ${SITE_ID}"

Response:

{
  "product": {
    "id": "abc123"
  }
}

Product Variants

Create Product with Variants

curl -X POST "https://www.wixapis.com/stores/v1/products" \
  -H "Authorization: ${API_KEY}" \
  -H "wix-site-id: ${SITE_ID}" \
  -H "Content-Type: application/json" \
  -d '{
  "product": {
    "name": "T-Shirt",
    "description": "Cotton t-shirt",
    "priceData": {
      "price": 19.99
    },
    "productType": "physical",
    "productOptions": [
      {
        "name": "Size",
        "choices": [
          {"value": "Small", "description": "S"},
          {"value": "Medium", "description": "M"},
          {"value": "Large", "description": "L"}
        ]
      },
      {
        "name": "Color",
        "choices": [
          {"value": "Red"},
          {"value": "Blue"},
          {"value": "Green"}
        ]
      }
    ],
    "manageVariants": true
  }
}'

Query Product Variants

curl -X POST "https://www.wixapis.com/stores/v1/products/query" \
  -H "Authorization: ${API_KEY}" \
  -H "wix-site-id: ${SITE_ID}" \
  -H "Content-Type: application/json" \
  -d '{
  "query": {
    "filter": "{\"id\": \"${PRODUCT_ID}\"}",
    "paging": {"limit": 1}
  }
}'

Extract variants from response:

{
  "products": [
    {
      "id": "product-123",
      "variants": [
        {
          "id": "variant-001",
          "choices": {
            "Size": "Small",
            "Color": "Red"
          },
          "variant": {
            "priceData": {
              "price": 19.99
            },
            "stock": {
              "trackQuantity": true,
              "quantity": 10,
              "inStock": true
            },
            "sku": "TSHIRT-S-RED"
          }
        }
      ]
    }
  ]
}

Update Variant Pricing

curl -X PATCH "https://www.wixapis.com/stores/v1/products/${PRODUCT_ID}" \
  -H "Authorization: ${API_KEY}" \
  -H "wix-site-id: ${SITE_ID}" \
  -H "Content-Type: application/json" \
  -d '{
  "product": {
    "variants": [
      {
        "id": "variant-001",
        "variant": {
          "priceData": {
            "price": 17.99,
            "comparePrice": 24.99
          }
        }
      }
    ]
  }
}'

Product Media

Add Main Image

curl -X PATCH "https://www.wixapis.com/stores/v1/products/${PRODUCT_ID}" \
  -H "Authorization: ${API_KEY}" \
  -H "wix-site-id: ${SITE_ID}" \
  -H "Content-Type: application/json" \
  -d '{
  "product": {
    "media": {
      "mainMedia": {
        "image": {
          "url": "https://static.wixstatic.com/media/your-image.jpg",
          "altText": "Product main image"
        }
      }
    }
  }
}'

Add Multiple Images

curl -X PATCH "https://www.wixapis.com/stores/v1/products/${PRODUCT_ID}" \
  -H "Authorization: ${API_KEY}" \
  -H "wix-site-id: ${SITE_ID}" \
  -H "Content-Type: application/json" \
  -d '{
  "product": {
    "media": {
      "items": [
        {
          "image": {
            "url": "https://static.wixstatic.com/media/image1.jpg",
            "altText": "First image"
          }
        },
        {
          "image": {
            "url": "https://static.wixstatic.com/media/image2.jpg",
            "altText": "Second image"
          }
        }
      ]
    }
  }
}'

Product Collections

Query Collections

Endpoint: POST https://www.wixapis.com/stores/v1/collections/query

curl -X POST "https://www.wixapis.com/stores/v1/collections/query" \
  -H "Authorization: ${API_KEY}" \
  -H "wix-site-id: ${SITE_ID}" \
  -H "Content-Type: application/json" \
  -d '{
  "query": {
    "paging": {"limit": 50}
  }
}'

Response:

{
  "collections": [
    {
      "id": "collection-123",
      "name": "Summer Collection",
      "slug": "summer-collection",
      "description": "Hot summer items",
      "visible": true,
      "numberOfProducts": 25
    }
  ],
  "metadata": {
    "count": 1,
    "total": 1
  }
}

Add Product to Collection

curl -X PATCH "https://www.wixapis.com/stores/v1/products/${PRODUCT_ID}" \
  -H "Authorization: ${API_KEY}" \
  -H "wix-site-id: ${SITE_ID}" \
  -H "Content-Type: application/json" \
  -d '{
  "product": {
    "collectionIds": ["collection-123", "collection-456"]
  }
}'

Remove Product from Collection

curl -X PATCH "https://www.wixapis.com/stores/v1/products/${PRODUCT_ID}" \
  -H "Authorization: ${API_KEY}" \
  -H "wix-site-id: ${SITE_ID}" \
  -H "Content-Type: application/json" \
  -d '{
  "product": {
    "collectionIds": []
  }
}'

Bulk Operations

Bulk Update Product Visibility

Endpoint: POST https://www.wixapis.com/stores/v1/bulk/products/update

Maximum: 100 products per request

curl -X POST "https://www.wixapis.com/stores/v1/bulk/products/update" \
  -H "Authorization: ${API_KEY}" \
  -H "wix-site-id: ${SITE_ID}" \
  -H "Content-Type: application/json" \
  -d '{
  "set": [
    {
      "id": "product-1",
      "property": "visible",
      "value": true
    },
    {
      "id": "product-2",
      "property": "visible",
      "value": true
    },
    {
      "id": "product-3",
      "property": "visible",
      "value": false
    }
  ]
}'

Response:

{
  "bulkActionMetadata": {
    "totalSuccesses": 3,
    "totalFailures": 0,
    "undetailedFailures": 0
  },
  "results": [
    {
      "itemMetadata": {
        "id": "product-1",
        "originalIndex": 0,
        "success": true
      },
      "item": {
        "id": "product-1"
      }
    }
  ]
}

Bulk Update Prices

curl -X POST "https://www.wixapis.com/stores/v1/bulk/products/update" \
  -H "Authorization: ${API_KEY}" \
  -H "wix-site-id: ${SITE_ID}" \
  -H "Content-Type: application/json" \
  -d '{
  "set": [
    {
      "id": "product-1",
      "property": "price",
      "value": 19.99
    },
    {
      "id": "product-2",
      "property": "price",
      "value": 29.99
    }
  ]
}'

Bulk Update Multiple Properties

Note: Use Bulk Adjust Product Properties endpoint for multiple properties per product

curl -X POST "https://www.wixapis.com/stores/v1/bulk/products/adjust" \
  -H "Authorization: ${API_KEY}" \
  -H "wix-site-id: ${SITE_ID}" \
  -H "Content-Type: application/json" \
  -d '{
  "products": [
    {
      "id": "product-1",
      "price": 19.99,
      "visible": true,
      "stock": {
        "quantity": 50
      }
    },
    {
      "id": "product-2",
      "price": 29.99,
      "visible": false
    }
  ]
}'

Common Product Patterns

Get All Products (Paginated)

#!/bin/bash

OFFSET=0
LIMIT=100
TOTAL=999999

while [ $OFFSET -lt $TOTAL ]; do
  response=$(curl -s -X POST "https://www.wixapis.com/stores/v1/products/query" \
    -H "Authorization: ${API_KEY}" \
    -H "wix-site-id: ${SITE_ID}" \
    -H "Content-Type: application/json" \
    -d "{\"query\": {\"paging\": {\"limit\": $LIMIT, \"offset\": $OFFSET}}}")

  echo "$response" | jq '.products[]'

  TOTAL=$(echo "$response" | jq '.metadata.total')
  COUNT=$(echo "$response" | jq '.metadata.count')

  OFFSET=$((OFFSET + COUNT))

  if [ $COUNT -eq 0 ]; then
    break
  fi
done

Find Products Below Reorder Point

curl -X POST "https://www.wixapis.com/stores/v1/products/query" \
  -H "Authorization: ${API_KEY}" \
  -H "wix-site-id: ${SITE_ID}" \
  -H "Content-Type: application/json" \
  -d '{
  "query": {
    "filter": "{\"stock.trackInventory\": true, \"stock.quantity\": {\"$lte\": 10}}",
    "sort": "{\"stock.quantity\": \"asc\"}",
    "paging": {"limit": 100}
  }
}'

Find Out of Stock Products

curl -X POST "https://www.wixapis.com/stores/v1/products/query" \
  -H "Authorization: ${API_KEY}" \
  -H "wix-site-id: ${SITE_ID}" \
  -H "Content-Type: application/json" \
  -d '{
  "query": {
    "filter": "{\"stock.inStock\": false, \"visible\": true}",
    "paging": {"limit": 100}
  }
}'

Find High-Priced Products

curl -X POST "https://www.wixapis.com/stores/v1/products/query" \
  -H "Authorization: ${API_KEY}" \
  -H "wix-site-id: ${SITE_ID}" \
  -H "Content-Type: application/json" \
  -d '{
  "query": {
    "filter": "{\"price\": {\"$gte\": 100}}",
    "sort": "{\"price\": \"desc\"}",
    "paging": {"limit": 50}
  }
}'

Product Schema Reference

Minimal Product

{
  "name": "Product Name",
  "price": 29.99,
  "productType": "physical"
}

Complete Product

{
  "name": "Product Name",
  "description": "Full product description",
  "price": 29.99,
  "comparePrice": 39.99,
  "cost": 15.00,
  "sku": "PROD-001",
  "productType": "physical",
  "visible": true,
  "slug": "product-name",
  "weight": 1.5,
  "stock": {
    "trackInventory": true,
    "quantity": 100,
    "inStock": true
  },
  "media": {
    "mainMedia": {
      "image": {
        "url": "https://static.wixstatic.com/media/main.jpg",
        "altText": "Main product image"
      }
    },
    "items": []
  },
  "collectionIds": ["collection-123"],
  "ribbon": "Sale",
  "brand": "Brand Name",
  "customTextFields": [],
  "productOptions": [],
  "manageVariants": false,
  "variants": []
}

Documentation References

Query Products: https://dev.wix.com/docs/rest/api-reference/wix-stores/catalog/query-products
Get Product: https://dev.wix.com/docs/rest/api-reference/wix-stores/catalog/get-product
Create Product: https://dev.wix.com/docs/rest/api-reference/wix-stores/catalog/create-product
Update Product: https://dev.wix.com/docs/rest/api-reference/wix-stores/catalog/update-product
Bulk Update: https://dev.wix.com/docs/rest/api-reference/wix-stores/catalog/bulk-update-product-property
Query Collections: https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v1/catalog/query-collections
Catalog V3 (Preview): https://dev.wix.com/docs/rest/business-solutions/stores/catalog-v3/products-v3/introduction

Product Management - Wix Stores API

Popularity

Invocation

Context Preview

SKILL.md

Similar Skills

Help us improve

Help us improve

Find plugins for your project

Product Management - Wix Stores API

Popularity

Invocation

Context Preview

SKILL.md

Product Management - Wix Stores API

Overview

Configuration

Query Products

Basic Query

Query Visible Products Only

Query Products by Price Range

Query Products by Collection

Get Single Product

Create Product

Update Product

Delete Product

Product Variants

Create Product with Variants

Query Product Variants

Update Variant Pricing

Product Media

Add Main Image

Add Multiple Images

Product Collections

Query Collections

Add Product to Collection

Remove Product from Collection

Bulk Operations

Bulk Update Product Visibility

Bulk Update Prices

Bulk Update Multiple Properties

Common Product Patterns

Get All Products (Paginated)

Find Products Below Reorder Point

Find Out of Stock Products

Find High-Priced Products

Product Schema Reference

Minimal Product

Complete Product

Documentation References

Similar Skills

Help us improve

Product Management - Wix Stores API

Overview

Configuration

Query Products

Basic Query

Query Visible Products Only

Query Products by Price Range

Query Products by Collection

Get Single Product

Create Product

Update Product

Delete Product

Product Variants

Create Product with Variants

Query Product Variants

Update Variant Pricing

Product Media

Add Main Image

Add Multiple Images

Product Collections

Query Collections

Add Product to Collection

Remove Product from Collection

Bulk Operations

Bulk Update Product Visibility

Bulk Update Prices

Bulk Update Multiple Properties

Common Product Patterns