The Wix Stores Catalog V3 is a comprehensive suite of APIs that revolutionizes how developers manage and interact with Wix Stores product catalogs. This next-generation catalog system provides a robust, scalable foundation for building sophisticated e-commerce applications with advanced product management capabilities.
It's important to note the following before starting to code:
- Each site supports either Catalog V1 or Catalog V3, but not both at the same time. Use the Catalog Versioning API to determine the API version of a given site.
- When you create a new dev site to test your app on, the dev site supports Catalog V3.
- If your app currently utilizes the Catalog V1 API, there are several important considerations:
- Catalog V3 will initially be rolled out to new users only.
- To continue supporting both new and existing users, your app will need to support both Catalog V1 and Catalog V3. You must confirm compatibility in your app's dashboard for Wix users to install your app.
- Over time, Catalog V3 will fully replace Catalog V1.
- Learn more about migrating from Catalog V1 to Catalog V3.
Catalog V3 provides a comprehensive suite of specialized services, each designed to handle specific aspects of product catalog management:
The core service for managing product information, variants, and basic product operations.
Key capabilities:
- Product lifecycle management - Create, update, delete, and query products with full variant support.
- Advanced variant handling - Manage complex product variations with options, choices, and pricing.
- Media management - Associate images, videos, and other media with products and product option choices.
- Bulk operations - Efficiently manage large product catalogs with bulk create, update, and delete operations.
- Search and filtering - Powerful query capabilities with flexible filtering and sorting.
- Product relationships - Manage product collections, cross-sells, and related product associations
Use Cases: Product catalog management, inventory synchronization, product import/export workflows, storefront product display
Dedicated service for sophisticated inventory tracking and stock management.
Key capabilities:
- Real-time stock tracking - Monitor inventory levels with automatic updates and availability calculations.
- Preorder and backorder management - Handle out-of-stock scenarios with flexible availability policies.
- Bulk inventory operations - Efficiently update inventory across large product catalogs.
Use Cases: Warehouse management, dropshipping workflows, multi-location retail, inventory forecasting
Enables rich product personalization and customization workflows for enhanced customer experiences.
Key capabilities:
- Product personalization - Allow customers to customize products with text, images, and design elements.
- Dynamic pricing - Adjust prices based on customization choices and complexity.
- Flexible input types - Support various customization inputs (text, images, colors, measurements).
- Customization templates - Create reusable customization patterns for product families.
- Validation rules - Ensure customizations meet business requirements and constraints
Use Cases: Print-on-demand products, personalized gifts, custom apparel, bespoke manufacturing
Manages additional product information sections for enhanced product descriptions and specifications.
Key capabilities:
- Rich content sections - Create detailed product information with various content types.
- Reusable content blocks - Share common information across multiple products.
- Structured data - Organize product specifications, features, and technical details.
- Content templates - Standardize product information across product categories.
- Multi-language support - Provide localized product information for global markets
Use Cases: Technical specifications, size charts, care instructions, warranty information, detailed product descriptions
Comprehensive brand management system for organizing products by manufacturer or brand identity.
Key capabilities:
- Brand profiles - Create detailed brand information with logos, descriptions, and metadata.
- Brand associations - Link products to brands with automatic organization and filtering.
- Brand templates - Standardize brand presentation across products.
Use Cases: Multi-brand retail, brand catalog organization, brand-based marketing campaigns, retailer partnerships
Flexible system for product badges, labels, and promotional highlighting.
Key capabilities:
- Promotional badges - Create "Sale", "New", "Featured", and custom promotional labels.
- Visual customization - Control ribbon appearance, colors, and positioning.
- Bulk ribbon management - Apply ribbons to multiple products with filtering and targeting.
Use Cases: Promotional campaigns, seasonal sales, new product launches, inventory clearance, product highlighting
Manages physical and virtual store locations for inventory and fulfillment operations.
Key capabilities:
- Location management - Create and manage store locations, warehouses, and fulfillment centers.
- Location-based inventory - Track inventory levels specific to each location.
- Service areas - Define delivery and service areas for each location.
Use Cases: Multi-location retail, regional inventory management, local delivery services, pickup locations
External service providing sophisticated category management that integrates seamlessly with Catalog V3.
Key capabilities:
- Hierarchical categories - Create nested category structures with unlimited depth.
- Category relationships - Manage parent-child relationships and category associations.
- Category metadata - Add descriptions, images, and SEO data to categories.
- Multi-category assignment - Assign products to multiple categories simultaneously.
- Category-based navigation - Enable structured browsing and filtering
Use Cases: Product organization, storefront navigation, catalog browsing, taxonomic product classification
Reach out to us via our Discord channel, or open a ticket with WixBot.