RECIPE: Business Recipe - Create Product (Catalog V1)

View the file in GitHub
Download skill
Copy

STEP 1: Create a Simple Product

Use POST https://www.wixapis.com/stores/v1/products to create a product.

CRITICAL: Description accepts an HTML string in V1 (unlike V3 which requires rich text nodes).

Copy

Key V1 fields:

FieldTypeNotes
namestringRequired. Max 80 characters
descriptionstringHTML string — NOT rich text nodes (e.g. "<p>text</p>")
productTypestring"physical" only (digital not supported via API)
priceData.pricenumberProduct base price
visiblebooleanWhether the product is visible to customers

STEP 2: Create a Product with Options

In V1, options are defined via productOptions. Variants are auto-generated from the choices — you do not need to define them manually.

Copy

V1 Options structure:

  • optionType: "drop_down" for text choices, "color" for color swatches
  • choices[].description: Display name shown to customers
  • choices[].value: Internal value (use hex color code for color type, e.g. "#000000")
  • choices[].inStock: Whether this choice is in stock
  • choices[].visible: Whether this choice is visible to customers

Variants in V1 responses are returned as an object with option name keys:

Copy

This is different from V3 which uses an array structure.

Key Differences from V3

FeatureCatalog V1Catalog V3
Create endpointPOST /stores/v1/productsPOST /stores/v3/products
DescriptionHTML string ("<p>text</p>")Rich text nodes object
Options fieldproductOptionsoptions
Option type fieldoptionType (drop_down, color)optionRenderType (TEXT_CHOICES, SWATCH_CHOICES)
Choice visibilitychoices[].visiblechoices[].isVisible
VariantsAuto-generated from choicesMust be explicitly defined in variantsInfo.variants
Variant choicesObject: {"Weight": "250g"}Array of optionChoiceNames
Price fieldpriceData.price (number)price.actualPrice.amount (string)

Important Notes

  • Never use /stores/v3/ endpoints on a CATALOG_V1 site — they return 428 Precondition Required.
  • Check the site's catalog version in dynamic context before choosing endpoints.
  • productType only supports "physical" via the API.
  • To add media to a product, use the separate Add Product Media endpoint after creation.
  • To query products on a V1 site, see Query Products (Catalog V1).

References

Did this help?