Skip to content

Commit 6dddcc3

Browse files
authored
Bulkassessmentupdate (#451)
<!-- This is an auto-generated comment: release notes by coderabbit.ai --> ## Summary by CodeRabbit * **Documentation** * Added a new guide for bulk (batch) assessment updates and workflow for courses * Included downloadable Excel template, editing instructions, a column/option reference table, and sample images * Documented step‑by‑step upload, assignment selection, processing status, and email notification behavior * Clarified teacher dashboard note about applying bulk updates for courses with multiple assessments * Added changelog entry announcing Batch Assessment Update <sub>✏️ Tip: You can customize this high-level summary in your review settings.</sub> <!-- end of auto-generated comment: release notes by coderabbit.ai -->
1 parent f2f72ba commit 6dddcc3

6 files changed

Lines changed: 90 additions & 1 deletion

File tree

41.3 KB
Loading
122 KB
Loading

source/instructors/authoring/assessments/assessments.rst

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,8 @@ Codio offers assessments that determine how well students understand course mate
1111

1212
Codio provides a Starter Pack project that contains examples for all assessment types and a guides authoring cheat sheet. Go to **Starter Packs**, search for **Demo Guides and Assessments**, click **Use Pack**, then click **Create** to install it to your Codio account.
1313

14-
You can view the results of assessments in a course from the teacher dashboard.
14+
You can view the results of assessments in a course from the teacher dashboard. For courses with multiple assessments, Codio also allows you to update assessment settings in bulk. For more information, see :ref:`batch-assessment-update`.
15+
1516

1617
**Assessment Topics**
1718

source/instructors/getstarted/support/changelog.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,7 @@ We do not report small bug fixes or issues that affect individual users, who we
1515

1616
**January 2026**
1717

18+
- `[F] [14th]`: Added :ref:`Batch Assessment Update <batch-assessment-update>` to update assessment settings in bulk using a .xlsx file.
1819
- `[I] [7th]`: Add a way to :ref:`Enable or disable extensions on a course level <course-coach-settings>`.
1920

2021
**December 2025**
Lines changed: 86 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,86 @@
1+
.. meta::
2+
:description: Batch Assessment Settings Update
3+
4+
5+
.. _batch-assessment-update:
6+
7+
8+
Batch Assessment Update
9+
=======================
10+
11+
You can bulk update many assessment settings, including points, partial points, use of maximum score, show expected answer, number of attempts, and showing rationale to students.
12+
13+
Before you begin, make sure to download the Excel (.xlsx) template file. You can download the Excel (.xlsx) template file for your course from **Download Assessment Template** in the **Assessment Settings** section of the **Bulk Settings** area. Update the fields as per your requirements and use that Excel (.xlsx) file to update the assessment settings.
14+
15+
Here is a sample screenshot of the template:
16+
17+
.. image:: /img/guides/assessment-screenshot-XLSX-bulk-template.png
18+
:alt: Sample XLSX Template
19+
20+
21+
Important notes about the template:
22+
- Edit only the white cells with dropdowns or number inputs.
23+
- Leave any cell set to **No Change** to keep the current published setting.
24+
- Gray cells labeled **Not Supported** or **Restricted** cannot be edited for the selected assessment type.
25+
- Save the file in XLSX format before uploading.
26+
27+
28+
29+
**Template field reference:**
30+
31+
32+
33+
.. list-table::
34+
:header-rows: 1
35+
:widths: 20 30 50
36+
37+
* - Column
38+
- Description
39+
- Available Options
40+
* - Assessment Type
41+
- Type of assessment
42+
- Predefined - cannot be modified
43+
* - Points
44+
- Point value for assessment
45+
- Numeric value (e.g., 20, 50, 100)
46+
* - Allow Partial Points
47+
- Whether partial credit is allowed
48+
- Yes, No, No Change, Not Supported
49+
* - Use Maximum Score
50+
- Whether to use maximum score
51+
- Yes, No, No Change, Not Supported
52+
* - Show Expected Answer
53+
- When to show expected answer
54+
- Always, Never, When Grades Are Released, No Change, Not Supported
55+
* - Defined Number of Attempts
56+
- Number of attempts allowed
57+
- No, 1-9, No Change, Not Supported
58+
* - Show Rationale to Student
59+
- When to show rationale
60+
- Always, Never, When Grades Are Released, Attempts, Score, No Change, Not Supported
61+
* - Value (for ATTEMPTS/SCORE)
62+
- Numeric threshold for Attempts or Score
63+
- 1-99 (attempts), 0-100 (score %), blank otherwise
64+
65+
66+
Once you have updated your Excel (.xlsx) template file, you are ready to bulk update the assessment settings.
67+
68+
69+
To bulk update the assessment settings, follow these steps:
70+
71+
1. On the **Courses** page, click the course you want to update the assessment settings for.
72+
73+
2. Go to **Bulk Settings** area and scroll to the **Assessment Settings** section.
74+
75+
3. In the **Assessment Settings** section click **Open updater**.
76+
77+
4. Select or drag and drop the Excel (.xlsx) file in which you have defined all the required settings.
78+
79+
5. Select the assignments you want to modify.
80+
81+
.. image:: /img/guides/select-excel-batch-update.png
82+
:alt: Select excel Batch Update
83+
84+
6. Click **Apply and Close**. A popup window will appear asking you to confirm, click **Yes**.
85+
86+
.. note:: A green banner will appear at the bottom of the page letting you know your updates are processing. Once the update is complete you will receive an email from Codio.

source/instructors/setupcourses/courses.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,7 @@ Courses Set Up
2727
bulk-assignment-update
2828
batch-groups-upload
2929
batch-student-tagging
30+
batch-assessment-update
3031
add-teachers
3132
add-ta
3233
add-remove-students

0 commit comments

Comments
 (0)