Skip to main content
Template best practices for imports
Updated this week

Anytime you’re importing a file into Yardstik, we’ll provide you with a template file so you can see the specific file formatting required for that import. We recommend that you always download the template file, because if the file you import doesn’t match the template’s format, it may fail.


In the case of ordering reports, the template file often differs based on the package you choose, so it won’t be available to download until you’ve chosen a package.

Columns and 1st row

You can hide them but do not delete. These are formatted specifically to match your selected package and are necessary for a successful upload.


Column headers

Invalid column headers will cause your entire file to fail.

  • All column headers included in the template must be included in your file

    • Even columns listed as optional must have a column present, even if you don’t fill in any info in the rows

    • You can include extraneous columns (they will be safely ignored)

  • All column header titles must be formatted exactly as those in the template file

Row content formatting

Invalid data in a row will not fail your whole file, but will cause that row to fail.

The first row of the file template will contain examples of how you’ll need to format the data in the rows. Make sure you format the data in your file to match.

  • no_middle_name

    • if the candidate does not have a middle name input TRUE or leave blank

    • if the candidate does have a middle name input FALSE

  • phone

    • phone number must include the country code and exclude spaces and dashes

      For example, 16125551234

  • ssn

    • must be in the format of xxx-xx-xxxx including the dashes

    • for social security numbers that begin with a zero, you may need to re-format those cells to plain text to ensure the leading 0s don't get removed

  • date_of_birth

    • must be in the yyyy-mm-dd format as shown in the template

  • driver_license_state

    • driver_license_state must be the two-letter abbreviation

  • state

    • state must be the two-letter abbreviation

  • zip_code

    • for zip codes that begin with a zero, you may need to re-format those cells to plain text to ensure the leading 0s don't get removed

  • country

    • country must be abbreviated as “US” for United States or "CA" for Canada

Errors

When you import your file, it will automatically check your file's column formatting. If it does not match the template's formatting, we will return an error message telling you which columns are missing.

You'll need to remove the file you attempted to upload using the (X) button and re-upload a file that includes all the correct columns/column header names.


If you have any questions, please message our support team directly using the purple chat icon in the bottom right-hand corner of this screen.

Did this answer your question?