Troubleshooting File Upload Problems
Whether you’re syncing data through your SIS or uploading files manually, errors can happen. This guide walks through the most common upload issues, why they occur, and how to fix them.
Common Issues
On Courses upload, getting: 422 Unprocessable Entity: Cannot update existing Parent Academic Unit
Causes: You are either -
- Attempting to update the parent unit of a course, which is not supported by the CSV upload.
- You are adding a Course that already exists.
Resolution: Based on which case it is:
- Contact support@classranked.com with the Subject: “Updating Course mappings”. In the body, include the course(s) you are attempting to update mapping for along with the new Parent Unit you are hoping to update it to. We will respond as soon as possible confirming your changes.
- No action needed.
On Courses upload, getting: {'category_id': 'Invalid category name.'}
Causes: An invalid Academic Unit type in the column does not match an Academic Unit type that exists in ClassRanked.
On Student Enrollments, Instructor Assignments, or Admin Role Assignments upload, getting: {'_schema': [{'user_id': 'Combination of email, role and division should be unique.'}, {'role_id': 'Combination of email, role and division should be unique.'}, {'section_id': 'Combination of email, role and division should be unique.'}]}
Problem: The role you are attempting to add for this user already exists.
Resolution: No action needed.
On Course Section upload, getting {'title': ['Title can only contain standard letters.']}
Problem: Currently, as a security precaution, we do not support characters outside of the standard ASCII set. Common characters that cause issues are “ñ”, “é”, etc.
Solution: Convert Title text to closest approximation of the existing name, sans special characters.
On Course Section upload, getting: 'NoneType' object has no attribute 'division_id'
Problem: There does not exist a course that this course section is an instance of.
- For example, you are trying to create CS 101-01 for the Fall 2027 term, but CS 101 does not exist.
Resolution: Create the course first and then create or re-upload this section.
Getting: Internal Server Error
Resolution: Please contact support@classranked.com with the Subject line: “Internal Server Error on CSV upload” and in the description provide the file you were attempting to upload with the error attached.
Potential Causes:
- One of your file’s field headers has a space at the start.
- We are currently fixing an issue where special accented characters such as “ñ” are getting thrown as an internal server error.
💡 Not finding your problem here? Contact us at support@classranked.com and we'll get you squared right away!