skills.rest
thisisjaymehta
thisisjaymehtaCOMMUNITY
Explore all skills by this author →
Website𝕏@thisisjaymehtaGitHub

wix-stores-versioning

Detects Wix Stores catalog version and routes SDK calls to V1 or V3 modules.

Updated Mar 20, 2026
Search Tags:#e-commerce#wix#sdk compatibility#inventory api#wix stores#catalog version#productsv3
One-click install
npx skills add https://github.com/thisisjaymehta/login-with-email-test --skill wix-stores-versioning-thisisjaymehta
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wix-stores-versioning
Source: https://github.com/thisisjaymehta/login-with-email-test/tree/main/.agents/skills/wix-stores-versioning
Command: npx skills add https://github.com/thisisjaymehta/login-with-email-test --skill wix-stores-versioning-thisisjaymehta

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @wix/stores.

What problem does it solve? Wix Stores has two catalog versions (V1 and V3) that are not backwards compatible, with different modules, payload structures, and field names. This Skill ensures your integration always calls the correct SDK module by checking the site's catalog version before any products, inventory, orders, or collections operation. ## Core Features & Use Cases - Catalog Version Detection: Call catalogVersioning.getCatalogVersion() at the start of every flow to determine whether a site uses V1_CATALOG, V3_CATALOG, or has Stores not installed. - Version-Aware SDK Routing: Route operations to productsV3/inventoryItemsV3 for V3 sites or products/inventory for V1 sites, handling their different payload structures. - Permissions Lookup: Use Wix MCP tools (SearchWixRESTDocumentation, ReadFullDocsArticle) to find required permissions for each API method and return them to the user. - Use Case: When building a Wix app that queries store products, first check the catalog version, then run productsV3.queryProducts() or products.queryProducts() accordingly, and subscribe to both V1 and V3 webhooks to support all sites. ## Quick Start Ask the AI to build a Wix Stores integration that checks the catalog version and queries products using the correct V1 or V3 SDK module.

Frequently Asked Questions about wix-stores-versioning

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check the Wix Stores catalog version in my app?▼

Call catalogVersioning.getCatalogVersion() from the @wix/stores SDK at the start of each flow. It returns V1_CATALOG, V3_CATALOG, or STORES_NOT_INSTALLED, and you branch your logic based on the result.

What is the difference between Wix Stores V1 and V3 catalog APIs?▼

V3 modules typically have a V3 suffix, such as productsV3 and inventoryItemsV3, while V1 uses products and inventory. The two versions have different payload structures, field names, nesting, and types, and are not backwards compatible.

Can a Wix site switch from V3 catalog back to V1?▼

No, catalog version is permanent per site and will not downgrade from V3 to V1. Your integration should still support both versions since different sites run different catalog versions.

How do I find required permissions for Wix Stores API methods?▼

Search for the method using the SearchWixRESTDocumentation MCP tool, then read the full documentation with ReadFullDocsArticle. The docs list the required permissions, which you should return to the user.

Which webhooks should I subscribe to for Wix Stores events?▼

Subscribe to both V1 and V3 webhooks so your integration handles events from all sites regardless of catalog version. Each version emits events with different payload structures.

Related Skills

Explore More Software Engineering Skills→
ESSSoWhatESSSoWhat

wix-stores-versioning

Detects Wix Stores catalog version and routes SDK calls to V1 or V3 modules.

Community
Intermediate
TechsioCZTechsioCZ
2

implement-cart-and-checkout-platform-flows

Coordinate cart and checkout workflows using storefront-data flow wrappers.

Official
Intermediate
nirganonnirganon

wix-stores-versioning

Detects Wix Stores catalog version and routes SDK calls to V1 or V3 modules.

Community
Intermediate
divinaarmueladivinaarmuela

wix-headless

Configures Wix Headless backends and generates SDK integration guides for frontend applications.

Community
Advanced