Serial Trail Serial Trail | Help Center

CSV import

Format, preview, commit, and safely roll back a supplier serial file.

Last updated: July 14, 2026

Contents

Import is a review-first workflow: upload, validate, inspect row errors, then commit. No unit enters the registry during preview.

File format

The required column is serial. An optional sku column checks that rows match the target pool.

serial,sku
ESP-000001,ESP-BLK
ESP-000002,ESP-BLK

Download the current template from Serials → Imports.

Preview and commit

The preview separates valid rows from invalid format, duplicate-in-file, duplicate-in-registry, and SKU mismatch errors. Download the error report, correct the source file, and upload again. Commit only after the counts agree with your file.

Excel and spreadsheet tips

  • Import the serial column as text so leading zeroes survive.
  • Save as UTF-8 CSV.
  • Remove formulas; cells beginning with =, +, -, or @ are data, not commands.
  • Keep one header row and no blank header names.

Rollback

A completed import can be rolled back while every imported unit is still Available. If any unit was assigned, sold, returned, or voided, rollback is blocked to preserve its history.

ℹ️
Every uploaded row ends in a counted terminal state. Serial Trail never silently drops a line.