Student Documents¶
Applies to: roles with Documents.View (view) or Documents.Manage (upload, download, delete). Last reviewed: 2026-11-18.
This page explains how to upload, view, download and delete documents kept against a student, such as a copy of an ID or a learner's licence.
1. Who can do what¶
| Action | Permission needed |
|---|---|
| See the Documents tab on the profile | Documents.View or Documents.Manage |
| View a document | Documents.View |
| Upload Document | Documents.Manage |
| Download a document | Documents.Manage on the web page |
| Delete a document | Documents.Manage |
As seeded, Administrator and Receptionist have both permissions; Manager, Instructor and Viewer have Documents.View only; Finance has neither. A school can change this in Settings > Roles (see Roles and permissions).
2. Where to find it¶
- Student profile > Documents tab, or
- the student's three-dot actions menu > Upload Document (from the Student Directory or the profile's bottom bar).
Screenshot to be added
Screen: Student Profile, Documents tab. Should show: the document table with the "Upload Document" button and an open row menu.
3. Uploading a document¶
- Open the student's profile and click the Documents tab.
- Click Upload Document (or Upload First Document if the list is empty). The Upload Student Document box opens.
-
Complete the box:
Field Required What it means Document Type Yes What the document is. Options: Identity Document, Learner's Licence, Driving Licence, Medical Certificate, Proof of Address, Proof of Payment, Other. Select Document Yes Click to choose one file from your computer. The file name and size are shown once chosen. Description No Shown as "Optional description". This text is not saved (see Limitations). -
Click Upload. A progress bar is shown.
- On success you see "Document uploaded successfully." and the document appears in the list.
Screenshot to be added
Screen: Upload Student Document box. Should show: a document type chosen and a file selected, showing its name and size.
Proof of Payment uploads fail
Choosing Proof of Payment as the document type makes the upload fail with "Unable to upload file." Until this is fixed, upload proofs of payment as Other. See Limitations and notes.
Rules¶
| Rule | Detail |
|---|---|
| File types offered | .pdf, .jpg, .jpeg, .png, .doc, .docx (the file picker filters on these). |
| Maximum size | 10 MB per file. |
| Files per upload | One. |
| Student status | Documents cannot be uploaded for an Inactive student. |
Messages¶
| Message | Cause |
|---|---|
| The maximum allowed file size is 10 MB. | The chosen file is larger than 10 MB. The selection is cleared. |
| Please select a document. | Upload was clicked without choosing a file. |
| Documents cannot be uploaded for an inactive student. | The student's status is Inactive. Activate the student first. |
| Student not found. | The student was deleted. |
| No file was provided. | The file arrived empty at the server. |
| Unable to upload file. / Unable to upload document. | The upload was refused without a specific message. See the Proof of Payment note under Limitations. |
4. The document list¶
Newest documents are listed first.
| Column | What it shows |
|---|---|
| Document | The original file name, with an icon for the file type. |
| Type | The document type as stored (for example "IdentityDocument", "LearnersLicence"). |
| Uploaded | Date and time of upload, in your local time. |
| Uploaded By | The name of the user who uploaded it, or "-". |
| Status | Always a green Successful chip. It means the upload succeeded; it is not a verification status. |
| (menu) | View, Download, Delete. |
If there are no documents you see "No documents uploaded."
View¶
Row menu > View. The file opens in the browser (PDFs and images display; other types depend on the browser). If the stored file is missing you see "Document file is not available."
Download¶
Row menu > Download (Documents.Manage). The file is saved under its original file name.
Delete¶
- Row menu > Delete (Documents.Manage).
- Confirm in the Delete Document box: "Are you sure you want to delete "(file name)"?" > Delete.
- You see "Document deleted successfully."
Deleting cannot be undone
Deleting removes the document from the list and deletes the stored file. It cannot be recovered from within DriveFlow.
5. Where documents are stored¶
For developers and whoever hosts the system
- Files are saved on the API server's own disk, in an
uploadsfolder under the API application's content root, in a sub-folder per student:uploads/students/{student id}/. - Each file is stored under a generated unique name with the original extension. The original file name is kept in the database and used when viewing and downloading.
- The storage service is
LocalFileStorageService(registered inDriveFlow.Api/Program.cs). There is no cloud storage implementation in the code. If the API is hosted on more than one server, or the server's disk is replaced, theuploadsfolder must be shared or backed up, otherwise documents will show "Document file is not available." - Downloads go through the API (
GET api/Students/{id}/documents/{documentId}/download), so files are only served to signed-in users with the right permission.
6. Example¶
Sipho brings a copy of his ID to reception.
- The receptionist opens Sipho's profile > Documents > Upload Document.
- Document Type: Identity Document. Select Document:
sipho-id.pdf(420 KB). - Upload. The list now shows
sipho-id.pdf, type IdentityDocument, uploaded just now by the receptionist, status Successful.
7. Limitations and notes¶
- Proof of Payment uploads appear to fail. The upload box sends the text "Proof of Payment" (with spaces) for this option, while the server expects the value
ProofOfPayment. The server cannot match it, so the upload is refused and the page shows "Unable to upload file." This is read from the code (UploadStudentDocumentDialog.razor,StudentsController.UploadDocument,DocumentType.cs); it was not run. Until fixed, upload proofs of payment as Other. - The Description is not saved. The box sends it, but the server does not read or store it, and the document list has no description column.
- Document types that exist but are not offered: Passport, PDP and Passport Photo exist in the system's list of document types but are missing from the upload box.
- File type and size are checked when you choose the file. The file picker offers only the listed types, and a file over 10 MB is cleared with a message.
- No expiry dates and no verification. A document has no expiry date, no "verified" flag in the UI, and no reminders. The server always reports documents as not verified; the "Successful" chip is fixed text.
- Documents are not linked to the learner's licence fields. Uploading a learner's licence does not tick Has Learners Licence; that is set on the student record (see Student training information).
- Students cannot upload their own documents through the student portal.
- A separate Documents page exists under Settings (
/settings/documents). It only displays "This section is not available yet." and has nothing to do with per-student documents.
Related articles¶
- Student profiles - the profile and its tabs.
- Student training information - learner's licence details on the student record.
- Student status management - why Inactive students cannot receive documents.
- Roles and permissions - the Documents permissions.