Skip to main content

Import Assets

Import multiple assets at once using a CSV file. The import feature creates groups, units, and locations automatically if they don't exist.


1. Access Importโ€‹

Navigation: Assets โ†’ Import from the sidebar.


2. Import Stepsโ€‹

Step 1: Download Templateโ€‹

  1. Click Download Template
  2. Open the CSV in Excel or a text editor
  3. The template includes column headers and example rows

Step 2: Fill in Your Dataโ€‹

Add one row per asset. Use the columns described below.

Step 3: Uploadโ€‹

  1. Click Select CSV File
  2. Choose your completed CSV file
  3. Click Import or Upload
  4. Review the import summary (imported count, failed count, errors)

3. Expected Columnsโ€‹

ColumnDescriptionRequired
asset_code or codeUnique code. Auto-generated if emptyNo
asset_name or nameAsset nameYes
quantity or amountQuantity. Default: 1No
unitUnit name (e.g., Pieces). Created if not existsNo
group or categoryAsset group. Created if not existsNo
locationLocation. Created if not existsNo
purchase_date or date_buyYYYY-MM-DD formatNo
warranty_months or warranty_periodWarranty in monthsNo
price or unit_priceUnit priceNo
depreciation_months or depreciationDepreciation period in monthsNo
supplier or supplier_nameSupplier nameNo
descriptionAsset descriptionNo
manufacturerManufacturerNo
model or model_numberModel numberNo
serial or seriesSerial numberNo

4. CSV Format Tipsโ€‹

  • Encoding: UTF-8 (with BOM for Excel compatibility)
  • Separator: Comma (,)
  • Headers: First row must contain column names
  • Dates: Use YYYY-MM-DD (e.g., 2025-01-15)
  • Empty values: Leave cell empty; defaults will apply

5. After Importโ€‹

  • Imported count - Number of assets successfully added
  • Failed count - Rows that could not be imported
  • Errors - List of errors (e.g., "Row 5: Missing asset name")

Fix errors in your CSV and re-import failed rows if needed.


6. Import Historyโ€‹

The module stores import history:

  • Filename
  • Total rows, imported, failed
  • Who imported, when
  • Error details

Check Settings or Import History (if available) to review past imports.


Best Practicesโ€‹

  • Test with a small file first (5-10 rows)
  • Match column names exactly to the expected format
  • Use consistent group/unit/location names for proper categorization
  • Backup before large imports - import cannot be easily undone