Uploading Marks and Feedback Files for Assignments Not Created on Moodle Link to heading

It is common for instructors to conduct assignments outside Moodle while still using Moodle to publish marks and individualized feedback. Since these assignments do not have a corresponding Moodle activity, there are no gradebook entries by default, making the process of uploading marks and feedback less straightforward.

This guide explains how to create a Moodle assignment for grading purposes and upload individual feedback files for all students.

Step 1: Create a Moodle Assignment Link to heading

Create a new assignment in Moodle. While configuring the assignment, ensure that the following Feedback types are enabled:

  • Feedback comments
  • Offline grading worksheet
  • Feedback files Save the assignment after completing the configuration.

Step 2: Download the Grading Worksheet Link to heading

After the assignment has been created:

  1. Open the assignment.
  2. Click the Actions menu.
  3. Select Download grading worksheet.

This will download a CSV file (for example, grading-worksheet.csv) containing the list of enrolled students.

Step 3: Generate Student Folders Link to heading

Create a directory named moodle-out.

Download the folder generation script from Link and execute:

python3 generate_folders_moodle.py grading-worksheet.csv moodle-out/

The script will create a separate folder for each student inside the moodle-out directory using the information from the grading worksheet.

Step 4: Copy Feedback Files Link to heading

Place the feedback file for each student into the corresponding folder created in the previous step.

Alternatively, you can use the helper script available at Link to automate this process.

Note: The helper script assumes that feedback files follow the naming convention RollNumber.log present in the logs folder. To copy run this:

bash copy_log.sh grading-worksheet.csv logs/ moodle-out/

If your files use a different naming convention, modify the script accordingly before running it.

Step 5: Create a ZIP Archive Link to heading

After verifying that all feedback files have been placed in the correct student folders, compress the entire moodle-out directory into a ZIP archive.

Do not zip the individual folders separately; Moodle expects a single ZIP file containing all student folders.

The directory structure should look similar to:

moodle-out/
├── Student A_123456_assignsubmission_file/
│   └── 220010001.log
├── Student B_654321_assignsubmission_file/
│   └── 220010002.log
└── ...

Step 6: Upload the Feedback Files Link to heading

  1. Open the Moodle assignment.
  2. Click the Actions menu.
  3. Select Upload feedback files in a ZIP.
  4. Upload the ZIP archive created in the previous step.

Before confirming the upload, Moodle will display a preview of the file mappings. Verify that the feedback files have been matched with the correct students, especially for a few sample entries, to ensure that the roll numbers correspond to the intended students.

Once the verification is complete, proceed with the upload.

Your marks and individual feedback files are now available to students through Moodle.