skills.rest
nirganon
nirganonCOMMUNITY
Explore all skills by this author →
GitHub

wix-stores-versioning

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

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

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. Calling the wrong API version breaks integrations, so developers need a reliable way to detect the site's catalog version and branch to the correct SDK module. ## 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 Branching: Route product, inventory, and collection operations to productsV3/inventoryItemsV3 (V3) or products/inventory (V1) based on the detected version. - Permissions Lookup: Use Wix MCP tools (SearchWixSDKDocumentation, 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() on V3 sites or products.queryProducts() on V1 sites, and subscribe to both V1 and V3 webhooks to support all sites. ## Quick Start Ask the assistant 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?▼

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

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

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

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

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

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

Search for the method with the SearchWixSDKDocumentation MCP tool, then read the full article with ReadFullDocsArticle to get the required permissions. Return those permissions to the user for each method used.

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

Subscribe to both V1 and V3 webhook events 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→
wixwix
25

wix-cli-site-plugin

Create Wix Site Plugins that inject custom elements into UI slots.

Official
Advanced
TechsioCZTechsioCZ
2

implement-cart-and-checkout-platform-flows

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

Official
Intermediate
zenbuappszenbuapps
1

shopline-payments-v1

Create payment sessions, process payments, and handle webhook events via Shopline Payments v1 API.

Official
Advanced
NimbleBrainIncNimbleBrainInc

wix

Manage Wix sites and integrate with Wix REST, SDK, and Headless APIs.

Official
Intermediate