Browse help topics

Import contractors from a spreadsheet

In this article: Upload a CSV or Excel file of your existing roster and review every row before anything is created.

Applies to Starter plan or above

If your roster already lives in a spreadsheet, put the file in rather than retyping it. Columns are detected automatically, and nothing is created until you've seen exactly what will be.

  1. Open the import screen

    Tools → Data Import. The Import menu on the contractor list goes to the same screen: pick Contractors or COIs and it opens on that step.

  2. Pick the spreadsheet option

    Choose Contractors — the other option is for a folder of certificates.

    CSV and Excel (.xlsx) both work.

    The Data Import screen asking whether to import contractors or certificates of insurance
  3. Upload the file

    Drop the file in. Columns are matched by their headers — a column called Name, Company or Contractor all land in the right place, and so do Email, Phone and License Number.

  4. Review the preview, then import

    You get a preview of every row before anything is written. Read it. This is where you catch a header row imported as a contractor called "Name", or a column that landed one across because of an empty cell.

    Untick anything you don't want, then click Import Selected.

    On a plan without bulk import you still get this preview — your own file, read and matched. In place of Import Selected there's a locked button naming the plan that imports it.

What the file needs

One contractor per row, and a header row naming the columns. A name column is the only thing that's really required; everything else is a bonus.

CSV, .xlsx and .xls are all read, and a file is taken as far as row 200. A longer roster comes in as two or three runs — split the file and upload the rest.

ColumnUsed for
Name / Company / ContractorThe contractor record. Required.
EmailWhere document requests and reminders go. Worth including — it saves typing it later for every contractor.
PhoneReference only.
License NumberGives license search something to match on.

Tip

Exporting from a spreadsheet you already keep? Don't clean it up first. Import it as it is, look at the preview, and you'll find out in ten seconds which columns actually matter.

Careful

A row whose name already matches a contractor you have is marked Duplicate in the preview and can't be ticked, so running the same file twice doesn't double your roster. A name that's only written differently — "Acme Roofing" against "A.C.M.E. Roofing LLC" — or an email at the same company domain is noted on the row as May be the contractor you already have, with a link. Those rows can still be imported: check them first.

What happens next

Your roster is in but empty of documents, so everyone shows as No Documents. Two good next moves: run them through license search, and start requesting certificates.

Importing subs you're vetting

To bring in a list of subs you haven't hired yet, start from Prospects in the sidebar and click Import. It's the same import, and everyone in the file is added as a prospect: not graded or chased until you approve them. See Vet a prospect, then approve or decline.

Related articles

Didn't find what you were looking for?

Send us the question — a person answers, usually the same working day.

Contact support