Skip to content

Import data

Import data bulk-loads your records from CSV files, so you can move an existing team and book of work into StaffMargin in minutes. You import one kind of record at a time, in a sensible order.

The Import data page with the entity options and CSV upload

You can import five kinds of record, each from its own CSV:

  • Employees, Clients, and Projects, the things you bill.
  • Costs and Salaries, the figures behind margin.

Import in that order where you can, because the later records reference the earlier ones. Projects belong to clients, and salaries and cost allocations attach to employees, so loading people and clients first means the links resolve.

Pick the kind of record, tell StaffMargin which tool you are exporting from so it can pre-fill the column mapping (or leave it on generic CSV to map the columns yourself), then upload a CSV whose first row is the column headers. StaffMargin reads the file, checks it, and reports what it loaded and what it could not, row by row, so a bad row is flagged rather than silently dropped. Fix the flagged rows in your file and import again. Rows that already exist are left alone, so a re-import is safe.

FAQ

What can I import?
Employees, clients, projects, costs and salaries, each from its own CSV file with a header row.
What order should I import in?
Load employees and clients first, then projects, then salaries and costs. Later records reference earlier ones, so the people and clients need to exist for the links to resolve.
What happens to a row with an error?
StaffMargin checks each row and reports what loaded and what did not, so a bad row is flagged rather than dropped. Fix it in your file and import again.
Is it safe to import the same file twice?
Yes. Rows that already exist are left alone, so re-importing after fixing a few rows will not create duplicates.