Home/Patterns/Import wizard

Import wizard

4-step bulk import. Three compositions for upload, mapping, and preview steps.

Stable3 compositions
COMPOSITION 01

Step 1 · Upload

Drop zone with accepted formats and a CSV template download.

Use whenThe first step. The operator has a file ready or needs the template.
1
2
3
4
Step 1 of 4

Upload your products file

CSV up to 5,000 rows. Download template.

Drop a CSV here
Or click to browse · max 5 MB
COMPOSITION 02

Step 2 · Map columns

Match CSV columns to Huchu fields. Auto-matches by header name first.

Use whenAfter upload — operator confirms which CSV column maps to which system field.
2
3
4
Step 2 of 4

Map columns

products-aug.csv · 412 rows. Map each CSV column to a Huchu field.

SKUauto-matched
Product nameauto-matched
Categoryauto-matched
Costunmapped
On-handauto-matched
4 of 5 mapped
COMPOSITION 03

Step 3 · Preview & resolve

First 10 rows rendered as they would import. Duplicates and validation errors surfaced inline.

Use whenAfter mapping — operator confirms data looks right and resolves any errors before commit.
Step 3 of 4

Preview · first 10 rows

412 rows total · 408 ready · 3 warnings · 1 error.

SKUNamePriceStatus
SKU-0001Mealie meal 10kg$ 8.20Ready
SKU-0421Mazoe Orange 2L$ 4.50Ready
SKU-0833Pro-bake bread loaf— missingMissing price
SKU-1102Cooking oil 750ml$ 3.20Duplicate · existing SKU
SKU-0945Sugar 2kg$ 3.80Ready
SKU-0598Long-life milk 1L$ 1.40Ready

Shared rules

Do

Auto-match by header name. Operators should only fix mismatches.

Don't

Commit on map. Always preview before commit.

Do

Allow saving an import template for repeat loads.

Don't

Discard mappings on back.