skills.rest
yaelbro
yaelbroCOMMUNITY
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 Apr 9, 2026
Search Tags:#migration#sdk#inventory#wix#wix stores#catalog version#products api
One-click install
npx skills add https://github.com/yaelbro/Shelf-Control --skill wix-stores-versioning-yaelbro
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wix-stores-versioning
Source: https://github.com/yaelbro/Shelf-Control/tree/main/.agents/skills/wix-stores-versioning
Command: npx skills add https://github.com/yaelbro/Shelf-Control --skill wix-stores-versioning-yaelbro

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 break when they call the wrong SDK module for a site's catalog version. ## Core Features & Use Cases - Catalog Version Detection: Calls 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: Routes product, inventory, and collection operations to the correct module (products vs productsV3, inventory vs inventoryItemsV3). - Permissions Lookup: Uses Wix MCP tools (SearchWixSDKDocumentation, ReadFullDocsArticle) to find required permissions for each API method. - Use Case: When building a Wix app that queries store products, first check the catalog version, then call productsV3.queryProducts() on V3 sites or products.queryProducts() on V1 sites, and subscribe to both V1 and V3 webhooks. ## Quick Start Ask the assistant to build a Wix Stores integration that checks the catalog version and queries products using the correct 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 logic based on the result.

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

V1 uses modules like products and inventory, while V3 uses V3-suffixed modules like productsV3 and inventoryItemsV3. The two versions are not backwards compatible and differ in 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 SDK methods?▼

Search for the method with the SearchWixSDKDocumentation MCP tool, then read the full article with ReadFullDocsArticle. The documentation lists the required permissions, which you should return to the user.

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

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
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
the-agency-aithe-agency-ai
39

pr-submit

Validate worktree state and dispatch structured PR readiness messages to captains.

Official
Intermediate