Comma
How-to Guides

Import shifts and expenses from a spreadsheet

Bring existing records into Comma from a CSV file.

  1. 1
    Choose what to import
    Shifts, expenses, or platform incomes.
  2. 2
    Map your columns
    Point your spreadsheet headers at Comma fields.
  3. 3
    Preview, then commit
    Nothing is written until the preview looks right.
The web importer takes any CSV with a header row. Amount and date are the only required columns.

Comma's full CSV importer is a web-app feature. The phone has a simpler CSV import under Settings → Data, covered at the end of this page.


On the web

1. Open the importer

Go to Import, or Settings → Data.

2. Choose what you're importing

Pick one: Shifts, Expenses, or Platform incomes.

3. Upload your CSV

The file needs a header row — the importer reads your column names from it.

4. Map your columns

Across a few steps, you match each column in your file to a field in Comma. What's required depends on what you're importing.

For Shifts:

ColumnRequired
Gross revenueYes
DateYes
Start timeOptional
End timeOptional
PlatformOptional
OrdersOptional
Distance (km)Optional
Dead mileageOptional
Out-of-pocketOptional
NotesOptional

For Expenses:

ColumnRequired
AmountYes
DateYes
CategoryOptional
PlatformOptional
Business use %Optional
RecurringOptional
NotesOptional

5. Preview, then commit

Before anything is saved, a preview shows the parsed rows and flags any conflicts with shifts you already have. Review it, then commit.


An example header row

A minimal shift file needs only Gross revenue and Date. A fuller one might look like this:

Date,Start time,End time,Platform,Gross revenue,Orders,Distance (km),Dead mileage,Out-of-pocket,Notes
2026-06-14,17:30,22:10,DoorDash,142.00,11,47,8,6.50,Friday dinner rush

On the phone

The phone's CSV wizard is simpler. It maps these columns:

ColumnRequired
PlatformYes
StartYes
EndYes
GrossOptional
TipsOptional
Active mileageOptional
Dead mileageOptional

Find it under Settings → Data. For a large file, the wizard suggests opening the Comma web app on a computer instead — mapping columns is fiddly on a small screen, and the web app writes to the same vault, so imported shifts land on your phone after the next sync.


On this page