skills.rest
ESSSoWhat
ESSSoWhatCOMMUNITY
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 Feb 21, 2026
Search Tags:#typescript#wix#sdk compatibility#inventory api#wix stores#productsv3#catalog versioning
One-click install
npx skills add https://github.com/ESSSoWhat/live-translate-realtime-dubbing --skill wix-stores-versioning-esssowhat
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wix-stores-versioning
Source: https://github.com/ESSSoWhat/live-translate-realtime-dubbing/tree/main/wix-app/np/.agents/skills/wix-stores-versioning
Command: npx skills add https://github.com/ESSSoWhat/live-translate-realtime-dubbing --skill wix-stores-versioning-esssowhat

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, so integrations that call the wrong SDK module fail or return mismatched data. This Skill ensures every Stores operation checks the site's catalog version first and uses the correct module. ## Core Features & Use Cases - Catalog Version Detection: Calls catalogVersioning.getCatalogVersion() at the start of each flow to determine whether a site uses V1_CATALOG, V3_CATALOG, or has Stores not installed. - Version-Aware SDK Routing: Routes product, inventory, and collection operations to productsV3/inventoryItemsV3 (V3) or products/inventory (V1) with the correct payload structures. - Permissions Lookup: Uses Wix MCP tools (SearchWixRESTDocumentation, ReadFullDocsArticle) to find and return the required permissions for each API method. - Use Case: When building a Wix app that queries store products, the Skill checks the catalog version first, then runs productsV3.queryProducts() on V3 sites or products.queryProducts() on V1 sites, avoiding incompatible payload errors. ## Quick Start Ask the assistant to build a Wix Stores integration that queries products while handling both V1 and V3 catalog versions.

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 before querying products?▼

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 route subsequent calls to the matching module.

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

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

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

No, catalog version is permanent per site and will not downgrade from V3 to V1. Integrations should subscribe to both V1 and V3 webhooks to handle all sites.

How do I find the required permissions for a Wix Stores API method?▼

Search for the method with the SearchWixRESTDocumentation MCP tool, then read the full article with ReadFullDocsArticle. The documentation lists the required permissions, which should be returned to the user.

What happens if I call the wrong catalog version module in Wix Stores?▼

V1 and V3 payload structures differ in field names, nesting, and types, so calling the wrong module produces errors or mismatched data. Always branch on getCatalogVersion() before any Stores operation.

Related Skills

Explore More Software Engineering Skills→
divinaarmueladivinaarmuela

wix-headless

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

Community
Advanced
imaginationeverywhereimaginationeverywhere

product-catalog-standard

Automate product catalog CRUD, inventory, search, and pre-order management.

Official
Advanced
nirganonnirganon

wix-stores-versioning

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

Community
Intermediate
cogni-workcogni-work
12

workspace-status

Diagnose cogni-works workspace health by verifying configuration files and dependencies.

Official
Intermediate