All Collections
ClassTag Connect
Tips & Resources
How do I create and upload Custom Student Attributes?
How do I create and upload Custom Student Attributes?
Instructions on how to upload a CSV file to create new student attributes and add them to student profiles.
Alex Karl avatar
Written by Alex Karl
Updated over a week ago

We understand that Schools keep a lot of information about their students to identify, characterize, filter, and sort them for a variety of purposes; meal plans, physical activities, bus routes, and many more.

Beyond the basic information such as their names and grade levels, you can now keep information about students' demographics, educational needs, and operational information such as bus routes, and other after-school activities.

You can achieve all of this with Custom Attributes!

❗Important notes❗

  • Custom Student Attributes will only be available to student profiles with Student IDs from your SIS sync.

  • We can only create Custom Student Attributes from the backend.

  • Custom Student Attributes are set either on the District or School levels.

Please reach out to to request to create the Custom Attributes for you. Once we have them added to your Schools, you can upload the CSV file and all information will attach to the student profiles.

Create a CSV file

You can create a CSV file to update Student Attributes in bulk. Please make sure that you already received a confirmation from our Support team that your Custom Attributes have been added before you upload any data with new Custom Attributes.

1. Create a spreadsheet. Sample/template here.

2. Fill out the columns with student information.

  • Column A MUST be named studentSisId. The capitalization must be copied as is to make the upload work. This is the list of the student IDs used when syncing with the school's rostering system; Clever, Classlink, OneRoster. The ID is found on the student profile.

  • Columns B onwards can be used for any attributes that you want to update. Type the name of the attribute on the first row (use the exact attribute name our Support team added). Then, any values added below these columns will be the selectable options for this Custom Student Attribute. There is no limit as to how many columns you can use at a time.

3. Save the file as a CSV. Then proceed to the uploading process.

Upload the CSV file

1. On the School page, go to the Settings tab.

2. Click SIS Rostering.

3. Click Upload on the Student Attributes section.

Note: The upload time depends on how big the file is. You can exit the page once it started and come back later to see if the upload is finished.

Profile example with Custom Attributes:

You're done! 🙌

If you need to add more students with specific attributes, you can update the attributes manually for each student's profile in the School Directory by following the same steps.

Explore More:

Did this answer your question?