Symptoms
- Only one product appears after importing many rows
- A Handle is reported as already taken
- Rows are ignored because they contain no product data
- An update does not match the existing product
Common causes
- The same Handle was copied across unrelated products
- A product row is missing its Handle or title
- Variant rows are separated from their product group
- Handles were regenerated while preparing an update file
How to check
- Group rows by Handle and confirm every group represents one product
- Confirm unrelated products have different Handles
- Confirm each product group begins with a complete product row
- Compare update Handles with the original export
How to fix
- Restore the original Handle for updates
- Assign a unique stable Handle to each new product
- Keep variant rows adjacent to the correct product Handle
- Do not change Handles merely to make row values look unique
Prevention
- Treat Handle as a stable identifier
- Edit from a recent Shopify export
- Check duplicate and blank Handles before every import
Evidence and scope
This page passed TinkerVane's Evidence Gate: a documented real problem, clear search intent, a matching file-level capability, a duplicate-content check, and an explicit overclaim boundary.