← Back to onboarding

CSV Template

Maintenance Records

Meaningful equipment maintenance that protects safety, downtime, warranty, and accountability.

Required to import

Maintenance ID, equipment ID, maintenance type, and status.

Can skip for now

Cost, receipt, parts used, next due date, and PIN signoff can be added later.

Template rows

The importer should skip rows marked instructions or example and import rows marked data.

Column Guide

CSV files cannot hold true spreadsheet comments, so this template uses an instruction row and an example row. That gives humans a map and gives the importer a clean way to skip non-data rows.

Maintenance External ID

maintenance_external_id
required

Unique ID you choose for this maintenance record.

Example: MR-001

Equipment External ID

equipment_external_id
required

Equipment this maintenance belongs to.

Example: EQ-001

Maintenance Type

maintenance_type
required

Oil Change, Blade Sharpening, Tire Repair, Safety Inspection, Winterization, or Other.

Example: Oil Change

Maintenance Date

maintenance_date
recommended

Date maintenance happened or is scheduled.

Example: 2026-05-01

Performed By Employee External ID

performed_by_employee_external_id
recommended

Employee who performed or logged the maintenance.

Example: EMP-003

Status

status
required

Scheduled, Completed, Skipped, Overdue, or Cancelled.

Example: Completed

Cost

cost
optional

Cost if known.

Example: 42.50

Notes

notes
recommended

Maintenance notes.

Example: Changed oil and filter

Next Due Date

next_due_date
recommended

Next due date if known.

Example: 2026-06-15

Requires PIN

requires_pin
recommended

TRUE if completion should require PIN signoff.

Example: TRUE

Completed PIN Employee External ID

completed_pin_employee_external_id
optional

Employee tied to PIN completion.

Example: EMP-003

Template preview

Copy this if the download button gets cranky. Real data rows should start with data in the _template_row column.

_template_row,maintenance_external_id,equipment_external_id,maintenance_type,maintenance_date,performed_by_employee_external_id,status,cost,notes,next_due_date,requires_pin,completed_pin_employee_external_id
instructions,Unique ID you choose for this maintenance record.,Equipment this maintenance belongs to.,"Oil Change, Blade Sharpening, Tire Repair, Safety Inspection, Winterization, or Other.",Date maintenance happened or is scheduled.,Employee who performed or logged the maintenance.,"Scheduled, Completed, Skipped, Overdue, or Cancelled.",Cost if known.,Maintenance notes.,Next due date if known.,TRUE if completion should require PIN signoff.,Employee tied to PIN completion.
example,MR-001,EQ-001,Oil Change,2026-05-01,EMP-003,Completed,42.50,Changed oil and filter,2026-06-15,TRUE,EMP-003
data,,,,,,,,,,,