CSV Pilot recognizes the product-template structure containing Product Name, Product Price and category or product identifiers, with English locale headers used to label it Yelo. The Yelo example contains two named sizes and one flat drink, together with the actual calculated Hyperzod output.
This support is for a specific template. It is not a complete migration of every Yelo file or add-on relationship.
Product mappings and add-on definitions are different files
Yelo's Add-ons documentation separates product mappings from definitions that supply add-on names, options and prices. A numeric Addon ID in a product mapping is not enough to reconstruct those definitions.
CSV Pilot does not currently upload and join the separate Add-ons file with the product template. Keep that file as a reference and build real modifier choices explicitly, or use another workflow that actually joins the two. Uploading it as a second product file is not a supported join operation.
How rows are grouped
The converter uses category plus base product name. It recognizes a trailing English size word such as Small, Medium, Large, Giant, Regular or Family, including before an Arabic suffix. A leading size word in Small Fries Box stays part of the name; a word inside a promotional name is not stripped.
Margherita Small and Margherita Medium in the same category therefore group as Margherita. The lowest row price becomes the base and other prices become deltas. In the example 6.50 and 10.00 produce a base 6.50 and choices +0.00 / +3.50.
Grouping does not require a nonempty Addon ID. Repeated same-category/base-name rows can merge even when IDs are blank. A single member remains flat; duplicate plain-name members can produce Default choices. Review merged records rather than trusting Addon ID as a guarantee that a row stays flat.
What the template maps
| Source | Implemented result |
|---|---|
| Product Name English, then Product Name* / Product Name | Product name |
| Product Description English or product description | Plain-text description |
| Category Name English or category name | Product category |
| Product Price* / Product Price | Full row price used for base and deltas |
| First nonempty SKU | Product SKU only |
| Positive MRP | Highest group compare price |
| Positive Available Quantity / Inventory* | Choice quantity and summed product inventory |
| Product Image Url | Main image; a Medium member image is preferred |
| Search Tags and Is Veg | Product tags |
The converter uses cost 0 and active status. It does not map a Yelo enabled/draft field. Check inactive source items before importing: they do not automatically stay inactive.
Zero or blank template quantities are treated as untracked. This is distinct from explicit product inventory 0 in a direct Hyperzod file. The template cannot reliably distinguish a sold-out item from an untracked one through this current rule.
Positive MRP values are retained; when a retained compare price is equal to or below the base, validation rejects the download. Correct the amount or remove an inappropriate compare price. The converter does not silently prove that an MRP is valid.
Selection groups and missing choices
Named size groups are required. Minimum Selection greater than 1 changes the group to MULTIPLE; other groups use Minimum Selection Required for the required flag. Exact range counts are not exported as an enabled RANGE.
When repeated rows have no readable size label, the converter can create Addon-number or Default placeholders. Its report warns that the choices need actual definitions. A placeholder is a diagnostic clue, not a customer-facing menu item you should publish.
Only one product-level SKU survives. Multiple source product IDs and variant SKUs do not become equivalent destination IDs or per-choice SKUs.
Verify your file
Upload the original in the workspace, ask for Hyperzod conversion and compare the result with the example. Inspect a named-size product, a flat item, an inactive source item and every linked add-on group.
Check grouping, full prices, inventory, status and readable labels. Replace placeholders using actual source definitions. Run a small destination import before moving a live menu. CSV Pilot is independent of Yelo, Jungleworks and Hyperzod.