RECIPE: Business Recipe – Initial Setup for a Wix Online Store (Catalog V3)

A concise checklist for preparing any new Wix site that uses the Online Stores app with Catalog V3. Notice that this recipe is NOT meant for coding porpuses and is ONLY meant for initial catalog setup.

URL: https://dev.wix.com/docs/kb-only/MCP_REST_RECIPES_KB_ID/TRAIN_stores_setup_online_store_catalog_v3

Article: Steps for Setting Up a Wix Online Store

YOU MUST Complete all the following steps in the given order (1 -5) without skipping any and without requiring additional user input. YOU MUST remind yourself as many times as needed throughout the process that you most complete all the steps and not stop at all in the middle.

⚠️ CRITICAL ORDER REQUIREMENT: You MUST start with creating products FIRST (Steps 1-2), then categories (Steps 3-5). Categories API might take some time to be fully available after Stores installation, so always create products before attempting category operations.

⚠️ ESSENTIAL NEXT STEP: After implementing this setup, YOU MUST continue to the Orchestration Recipe in order to create a client site to the site. This is required unless explicitely requested to only setup the Catalog: https://dev.wix.com/docs/kb-only/MCP_REST_RECIPES_KB_ID/TRAIN_stores_product_page_sdk

STEP 1: Confirm Catalog V3 & Stick to V3 APIs

STEP 2: Create 5 new products based on the format specified in the TRAIN_stores_bulk_create_products_with_options recipe (4 in stock, 1 out of stock)

  1. First YOU MUST pull up the TRAIN_stores_bulk_create_products_with_options recipe to understand the exact format required for creating products.
  2. Create 5 products according to this format using bulk creation (use a single bulk request). 4 of the created products MUST have ALL there variants in-stock, and the last (5th) product MUST have all its variants be out-of-stock.
  3. Make sure to add in image (using media) using a url from the web that matches each product.
  4. YOU MUST use the price formatting as seen in the example, meaning using actualPrice and compareAtPrice.
  5. ALL products MUST be created EXACTLY from the same format as the full example in the TRAIN_stores_bulk_create_products_with_options recipe. ONLY information within the strings of the given fields may differ based on the products.

⚠️ CRITICAL: EXACT FORMAT REQUIREMENTS YOU MUST use the following recipe to create ALL products with the EXACT same format:

STEP 3: Prepare Three Store Categories

  1. Determine how many categories the user requested.
  2. If fewer than 3 are provided, create additional categories until the total equals 3 which are relevant for the type of store.
  3. Examples for different types of stores:
  1. Use the Categories API to create each category. YOU MUST USE the endpoint: Create Category based on the example below. ⚠️ CRITICAL: Use correct endpoint /categories/v1/bulk/categories/{categoryId}/add-items with catalogItemId, appId: "215238eb-22a5-4c36-9e7b-e7c08025e04e", and treeReference object. When calling the endpoint, make sure the request body includes a top-level treeReference field. It must not be nested inside the category object.

Use the following example format:

'{
       "category": {
         "name": "Drinkware",
         "description": "The Drinkware category includes a wide range of containers designed for holding beverages",
         "visible": true
       },
       "treeReference": {
         "appNamespace": "@wix/stores",
         "treeKey": null
       }
   }'

STEP 4: Add Each Product to a Category

  1. YOU MUST add each existing product to at least one category that most makes sense.
  2. First acquire the product's ids to use for this action.
  3. Then adding a product to a category MUST be done using the Category API, specifically (Bulk Add Items To Category)[https://dev.wix.com/docs/rest/business-management/categories/bulk-add-items-to-category], where products are referred to as items. This endpoint enables adding multiple products at once to a category.

⚠️ CRITICAL: Use correct endpoint /categories/v1/bulk/categories/{categoryId}/add-items with catalogItemId, appId: "215238eb-22a5-4c36-9e7b-e7c08025e04e", and treeReference object. Make Sure you pass the treeReference correctly at the same level as "items".

STEP 5: Ensure Each Product was Added to a Category

  1. YOU MUST ensure that each product is connected to at least one category.
  2. You MUST do this by using the (List Items In Category)[https://dev.wix.com/docs/rest/business-management/categories/list-items-in-category] for EVERY Category (for example: 3 required api calls for 3 categories). If the list of items is empty, it means that the product was not added to that category and YOU MUST repeat step 4. The path for this endpoint in REST is: https://www.wixapis.com/categories/v1/categories/{categoryId}/list-items
  3. When calling the endpoint, make sure the request body includes a top-level treeReference field. It must not be nested inside the category object.

Conclusion

Following these steps in order guarantees the creation flow for new V3 Wix Online Store sites:

🚨 CRITICAL NEXT STEPS

This is not optional - without this next steps, your store will be incomplete and have no visual side.