{"id":60,"date":"2025-11-27T05:46:02","date_gmt":"2025-11-27T05:46:02","guid":{"rendered":"https:\/\/blog.scholaright.com\/?p=60"},"modified":"2026-03-14T04:33:08","modified_gmt":"2026-03-14T04:33:08","slug":"getting-started-part-3-importing-records","status":"publish","type":"post","link":"https:\/\/blog.scholaright.com\/index.php\/2025\/11\/27\/getting-started-part-3-importing-records\/","title":{"rendered":"Getting Started: Part 3, Importing Records"},"content":{"rendered":"\n

In Getting Started Part 1<\/a> and Part 2<\/a>, you learned how to create and track records in Scholaright<\/a>. But you’ve probably been tracking grades for years and you don’t want to lose all of that or suffer a repetitive strain injury clicking all these buttons to recreate your data. Scholaright provides two ways to bring your existing records in so you can keep everything in the same place. First, we will cover the manual import process. Then, we will cover the auto import feature, which takes various types of files, scans, and photos and turns them into courses, assignments, and grades.<\/p>\n\n\n\n

Manual import<\/h2>\n\n\n\n

This method will take more work, but also gives you the greatest control over what gets imported. To get started, expand the Courses<\/strong> menu on the left and click on Import Records<\/strong>.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

On the next screen, click the Download Template<\/strong> button. This will download a spreadsheet (CSV) with some sample data filled in based on students you’ve added to your school.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Now, you can fill in all of your course and assignment details and then upload the file back into Scholaright<\/a>.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Let’s cover how these columns get used…<\/p>\n\n\n\n

Column name<\/strong><\/td>How to use it<\/strong><\/td><\/tr>
academicYearLabel<\/td>Enter a start and end year with a hyphen in between with no spaces. For example: 2024-2025<\/strong>. This is the academic year where the grade information will be added. If a matching academic year exists, it will be used. If not, a new one will be created.<\/td><\/tr>
studentId<\/td>There are two types of student IDs in Scholaright: the Scholaright ID and what we call the UUID. The import process uses the latter, which looks like 6560d282-e4ea-433c-ae57-0741a8189edc<\/strong>. This ties the assignment to the correct student. The sample file will contain real IDs for your students, but you can also find these IDs by opening Students<\/strong> and clicking on your student’s name. The UUID will be at the end of your browser’s address bar. For example: https:\/\/app.scholaright.com\/students\/6560d282-e4ea-433c-ae57-0741a8189edc<\/strong> (pictured below)<\/td><\/tr>
studentName-optional<\/td>This is not used for the import and only exists to help you keep track of which student the assignment is for. You can leave it blank.<\/td><\/tr>
courseName<\/td>The name of the course this assignment should be added to. If there is a course that matches the academic year, name, and grade level, the assignment grade will be added to it. If not, a new one will be created.<\/td><\/tr>
courseGradeLevel<\/td>The grade level of the course: K-12.<\/td><\/tr>
courseCredits<\/td>How many credits the course is worth. This is needed if the course has to be created. Remember, a course that lasts one semester is generally .5 credits, while a full-year course is 1.<\/td><\/tr>
courseTerm<\/td>The name of the term\/semester this course belongs in. The import will match the term by name and, if the term does not exist, it will be created.<\/td><\/tr>
courseQuarter<\/td>If you use quarters, this should be the name of the quarter (e.g.: Q1, Q2, etc.) to which this assignment belongs. If a match is not found, a new quarter will be created.<\/td><\/tr>
passFailCourse<\/td>Mark this as “yes” if this course should only be graded as pass\/fail, instead of with a percentage and letter grade. Otherwise, leave it empty.<\/td><\/tr>
assignmentName<\/td>The name of the assignment. If a matching assignment is found in the course, the student’s score will be added to the existing assignment. Otherwise, a new one will be created.<\/td><\/tr>
assignmentMaxScore<\/td>The maximum score possible on the assignment.<\/td><\/tr>
assignmentWeight<\/td>The weight of the assignment.<\/td><\/tr>
assignmentType<\/td>The assignment type. Current options are test, milestone, homework, and project.<\/td><\/tr>
assignmentStudentScore<\/td>The score your student received on this assignment.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\"\"<\/figure>\n\n\n\n

The above image demonstrates where to find your student’s UUID.<\/p>\n\n\n\n

After you have everything filled in, simply upload the file from the Import Records<\/strong> menu item in Scholaright<\/a>.<\/p>\n\n\n\n

Auto Import<\/h2>\n\n\n\n

The auto import<\/em> leverages AI to turn any of your records into academic years, courses, assignments, and scores. You can send spreadsheets, document, scans, and even photos of previous grades. There does need to be enough information for the AI service to identify the year, courses, scores, etc. However, you do not need<\/em> to include your student’s personal information. Scholaright<\/a> does not share student IDs or names with the AI service, but anything included in your photos and files will be sent as-is. If this is a concern, please redact personal information before uploading.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

This is an example of a grade sheet the auto import was able to use. It can determine if the course is pass\/fail or graded. If the term names do not match an exiting term, you will have a chance to correct it before completing the import.<\/p>\n\n\n\n

To get started, assemble the files, scans, and photos of your student’s grades. Expand the Courses<\/strong> item on the left, and then click on Auto Import<\/strong>.<\/p>\n\n\n\n

Choose the student you want to upload records for and then click Upload and process with AI<\/strong>.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

You should get an Upload Successful<\/strong> message, which means that your file was uploaded, but it has not yet been processed. After a minute or so, the status should turn to Completed<\/strong> or Needs Review<\/strong>. If a review is needed, it means some data points, like term, need to be fixed up or confirmed.<\/p>\n\n\n\n

You don’t have to wait on the auto import screen while the auto import runs. When it completes, if any review is needed, a notification will appear in the top bar like this:<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Click this icon and then click Review & Approve<\/strong> on the next screen.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Make any necessary changes and then click Accept & Approve<\/strong> at the bottom of the screen.<\/p>\n\n\n\n

In the below example, Scholaright<\/a> couldn’t find a term named “First” so it offered to select a different term to use for all of these courses and assignment.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Now you can go into Courses<\/strong> on the left menu and see all your imported records. Note that you may need to switch to the imported academic year to see these newly imported courses. Your imported records will also be included in your students’ GPA and reports.<\/p>\n\n\n\n

Summary<\/h2>\n\n\n\n

As you can see, there are two methods to get existing records into Scholaright<\/a>. Which is best is up to you. The auto import requires a bit more double-checking but offers a lot of convenience over the manual import. If you have trouble with either, please reach out to us at support@schoalright.com.<\/p>\n","protected":false},"excerpt":{"rendered":"

In Getting Started Part 1 and Part 2, you learned how to create and track records in Scholaright. But you’ve probably been tracking grades for years and you don’t want…<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[],"class_list":["post-60","post","type-post","status-publish","format-standard","hentry","category-documentation"],"_links":{"self":[{"href":"https:\/\/blog.scholaright.com\/index.php\/wp-json\/wp\/v2\/posts\/60","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blog.scholaright.com\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.scholaright.com\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.scholaright.com\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.scholaright.com\/index.php\/wp-json\/wp\/v2\/comments?post=60"}],"version-history":[{"count":7,"href":"https:\/\/blog.scholaright.com\/index.php\/wp-json\/wp\/v2\/posts\/60\/revisions"}],"predecessor-version":[{"id":101,"href":"https:\/\/blog.scholaright.com\/index.php\/wp-json\/wp\/v2\/posts\/60\/revisions\/101"}],"wp:attachment":[{"href":"https:\/\/blog.scholaright.com\/index.php\/wp-json\/wp\/v2\/media?parent=60"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.scholaright.com\/index.php\/wp-json\/wp\/v2\/categories?post=60"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.scholaright.com\/index.php\/wp-json\/wp\/v2\/tags?post=60"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}