Help / Inventory / Importing from a spreadsheet
Inventory
Importing from a spreadsheet
Load a batch of equipment at once from a CSV instead of adding items one by one.
When you’re logging a lot of gear at once — say, a whole shelf — it’s faster to list it in a spreadsheet and import it than to add each item by hand. Snipe-IT reads a CSV and creates the assets (and, if needed, the categories, manufacturers, and models it hasn’t seen before).
The spreadsheet
Make a CSV with one row per physical item and a header row. These columns cover most of what we track:
Category,Manufacturer,Model Name,Asset Name,Serial,Status,Location,Ownership
VR HMD,Meta,Quest 3,,ABC123,Ready to Deploy,Storage Cabinet A,NUILAB
VR HMD,Meta,Quest 3,,DEF456,Ready to Deploy,Storage Cabinet A,NUILAB
Cameras,Sony,ZV-1,,SN9911,Ready to Deploy,Lab 215,Ortega
A few things worth knowing:
- Leave Asset Tag out (or leave it blank). The system assigns the next tag
(
NUI-000007, and so on) automatically. - Category, Manufacturer, and Model are created for you if they don’t exist yet — so spell them exactly the way you want them, and reuse existing names rather than inventing variants (see the conventions ).
- Serial can be blank if the item has no serial.
- Ownership is a custom field; if you leave it out, new items default to NUILAB.
Running the import
- Open the importer (top of the Assets list, or Import).
- Upload your CSV.
- On the mapping screen, match each of your columns to the matching Snipe-IT field. The names above map cleanly; check that Ownership maps to the custom field.
- Run the import, then spot-check a few of the new assets.
Try a small file first. Import three or four rows, confirm they look right, then run the full list. Fixing a mapping mistake across 100 rows is more work than a two-row test.
If you want a starter template or you’re importing something unusual, ask Francisco.
Source: content/systems/inventory/bulk-import.md · maintained in the lab docs repository.