Import from CSV: the wizard, step by step

Import from CSV: the wizard, step by step

The CSV import is a step-by-step wizard: you upload a file, confirm how its columns map, preview exactly what will happen, then save. Use it for any record type, and it is the way to bring in stocktakes (the Stocky API cannot). For what each record type brings across, see the "What comes over from Stocky" guide in this section.

Before you start

  • Save your data as a real CSV (not .xlsx, .xls, Numbers, or PDF), one record type per file , with a header row and at least one row of data. Keep each file under 30MB ; split larger exports into smaller files. Saving as "CSV UTF-8" is best for accented characters.
  • Finish syncing your Shopify products first , so every line can attach to the right product.
  • If you are importing stocktakes or adjustments, set up your store locations first (locations are not created for you).

The four steps

The wizard shows four steps across the top: Upload file, Match columns, Preview, and Done.

1. Upload

  • Source: choose Stocky (auto-match columns) so Organizely fills in the column matching for you. ("Generic CSV" is for files that did not come from Stocky.)
  • Record type: pick Purchase orders, Stocktakes, Suppliers, or Adjustments. (Products are not here, they come from your Shopify sync, and Transfers are not offered.)
  • A blue "Before you upload" note lists the columns that record type needs. For stocktakes and adjustments, an amber note reminds you that your live stock is not changed.
  • Optionally click Download a template CSV to see the exact columns Organizely expects.
  • Choose your file and click Upload and continue . Organizely reads the columns. Nothing is imported yet.

2. Match columns

  • Organizely shows each of your columns with a sample value and a Maps to field. For a Stocky file the matches are already filled in, so you usually just glance over them.
  • Required fields are marked with an asterisk, and the Preview button stays disabled until they are all matched. (Stocktakes have no strictly required columns, so you may not see an asterisk there; just make sure Current Stock and a product-match column such as SKU are mapped.)
  • To leave a column out, set its Maps to field to Don't import . To undo your changes, click Reset to suggested .
  • Click Preview (dry run) when everything looks right.

3. Preview (a safe dry run)

  • The preview checks every row and shows what would happen, without saving anything.
  • You see four counts: Would create , Would update , Skipped , and Errored .
  • Row issues lists anything to look at. Errors block that one row; warnings still import. "Data row 1" means the first row after your header (line 2 in your spreadsheet). The list shows up to the first 200 issues; if there are more, fix these and re-run to surface the rest. Download issues (CSV) saves the issues shown.
  • If it says Nothing would be imported , go back and check your column matching, especially the required fields.

4. Commit

  • Click Commit import , then confirm. Large imports run in the background, so keep the tab open until they finish. You then land on the Done step with a final summary.

Re-running is safe

  • For purchase orders, adjustments, and suppliers, re-importing the same file updates the same records instead of creating duplicates (they are matched by their Stocky id, or by name for suppliers).
  • Stocktakes are matched on the file's contents (a Stocky stocktake file has no id of its own), so re-importing the same stocktake file also updates the same stocktake instead of creating a duplicate.

If an import looks stuck

If you see an "already running" message but no import is actually in progress, wait a minute first (a large import may still be finishing in the background). If it persists, use the Reset stuck import button and try again. Re-running is safe.

Need help?

If you hit a snag, see  the Stocky migration overview  for the other guides, or reach out to our  support team .