Supported validation rules
The 18 checks currently defined for the browser-local V1 validator.
File checks, not an import guarantee
These rules cannot inspect your store settings, existing catalog, or remote image availability.
| Rule | Check | Severity | Source |
|---|---|---|---|
| F001 | The file is empty or contains only empty records. | Critical | Shopify guidance |
| F002 | The file cannot be decoded as strict UTF-8. | Critical | Shopify guidance 1Shopify guidance 2 |
| F003Fix quoting | CSV quoting is malformed or left unclosed. | Critical | Shopify guidance |
| F004 | A record has a different field count from the header. | Critical | Shopify guidance |
| F005 | The header contains duplicate column names. | Critical | Shopify guidance |
| F006 | The file starts with a UTF-8 byte order mark. | Info | Internal format check |
| F007 | Record separators mix CRLF, CR, and LF. | Info | Shopify guidance |
| H001Fix missing headers | The required Title column is missing. | Critical | Shopify guidance |
| H002Fix missing headers | A URL handle is missing where update or variant context requires one. | CriticalWarning | Shopify guidance |
| H003 | A header is outside the supported current, legacy, market, collection, and metafield set. | Warning | Shopify guidance |
| H004 | A supported legacy header has a current replacement. | Info | Shopify guidance |
| P001 | The first product record has no Title and is not an image-only continuation. | Critical | Shopify guidance 1Shopify guidance 2 |
| P002 | A URL handle contains spaces. | Critical | Shopify guidance |
| V001Fix duplicate options | Variants under one handle repeat the same option combination. | Critical | Shopify guidance |
| V002 | Variant fields are present without the required Option1 name or value. | Critical | Shopify guidance |
| V003 | One non-empty SKU maps to multiple products or variants. | Warning | Internal format check |
| D001 | A price is not a non-negative dot-decimal value. | Critical | Shopify guidance |
| I001 | An image URL is not absolute HTTP(S) or is an obvious local path. | Warning | Shopify guidance 1Shopify guidance 2 |
Detection limits
Image links are checked for URL syntax only. Unknown headers may be valid app fields. Intent-sensitive rules use the import intent selected by the user.
Last verified against source guidance: 28 September 2026