Importing Labels

Liz Gehret -

Labels are tags that you apply to data you have stored in Handshake to help your classify and organize that data. There are three types of labels in Handshake (normal, public, and system). This article will highlight the process to bulk import either normal or public labels onto data in Handshake via the Importer.

Labels can be imported at any time after your students are uploaded!

NOTE ABOUT LABEL LIMITS: You can only import 10 unique labels per file.  You can include as many rows as you'd like, but if you have more than 10 different labels in the file, you should split your existing file into multiple separate CSV files.


  1. Ensure that you have access to the Importer Tool.
  2. Review this label overview article + understand how to manually add/edit a label. 

High Level Workflow:

  1. Format your CSV file according to the specifications below
  2. Upload to the Importer with the file-type "Labels"
  3. Review any error messages or file warnings once analysis completes
  4. Choose the button to Submit and Request Run

Example File:



.CSV Formatting:

Required Fields:

NoteField options in italics are case sensitive and must match exactly although headers can be added in any order in your CSV file.

  • identifier
    • This cannot be the username (unless the username is the email address)
    • This is the student or contact's email address
      • If any email address that is included in your file is not associated with an existing account in Handshake, the label will fail to be applied
    • If uploading Employers, this is the Employer ID
  • identifiable_type (must be one of the following:)
    • User
    • Contact
    • Employer
  • user_type  (must be one of the following:)
    • Students
    • Career Services
    • Leave blank if you are uploading Contacts, Employers
  • name
    • This is the name of the label you want to use (only one label per row is allowed)


Optional Fields:

  • label_type 
    • normal
    • public

 Note: Normal labels will be visible by all career center staff at your institution, and public labels will be visible by career center staff and students at your institution. These labels will never be visible by users associated with another institution.

Additional Resources: 

Was this article helpful?
4 out of 12 found this helpful
Have more questions? Submit a request