103 "when": "Use for plugin rules, source-only metadata, or catalog semantics that do not fit product extended fields."
104 }
105 ],
106 "reliability": {
107 "status": "partially-reliable",
108 "flags": []
109 },
110 "pitfalls": [
111 {
112 "code": "catalog-v3-normalization",
113 "severity": "blocker",
114 "summary": "Normalize V1/simple product fields into Catalog V3 product and variant shapes before create."
115 },
116 {
117 "code": "variant-matrix-two-pass",
118 "severity": "warning",
119 "summary": "Full variable product matrices require a post-create option-choice and variant pass."
120 }
121 ],
122 "mappingGuidance": [
123 "Create categories, brands, tags, and media references before products when the source uses them; assign brands by crosswalked brand.id, never by name (see stores/brand).",
124 "Preserve recurring offers natively via product.subscriptionDetails.subscriptions[] when the source exposes clear cadence data; live create coverage was verified on July 26, 2026, while patch/update coverage remains unverified."
125 ],
126 "setupRequirements": [
127 "Wix Stores app",
128 "Product data extension schema when source-only product fields are preserved natively."