diff --git a/source/img/guides/assessment-screenshot-XLSX-bulk-template.png b/source/img/guides/assessment-screenshot-XLSX-bulk-template.png new file mode 100644 index 00000000..96b06c36 Binary files /dev/null and b/source/img/guides/assessment-screenshot-XLSX-bulk-template.png differ diff --git a/source/img/guides/select-excel-batch-update.png b/source/img/guides/select-excel-batch-update.png new file mode 100644 index 00000000..b1755bd4 Binary files /dev/null and b/source/img/guides/select-excel-batch-update.png differ diff --git a/source/instructors/authoring/assessments/assessments.rst b/source/instructors/authoring/assessments/assessments.rst index a0f1bbbb..d94573d9 100644 --- a/source/instructors/authoring/assessments/assessments.rst +++ b/source/instructors/authoring/assessments/assessments.rst @@ -11,7 +11,8 @@ Codio offers assessments that determine how well students understand course mate 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. -You can view the results of assessments in a course from the teacher dashboard. +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`. + **Assessment Topics** diff --git a/source/instructors/getstarted/support/changelog.rst b/source/instructors/getstarted/support/changelog.rst index 6d2e7a39..52352594 100644 --- a/source/instructors/getstarted/support/changelog.rst +++ b/source/instructors/getstarted/support/changelog.rst @@ -15,6 +15,7 @@ We do not report small bug fixes or issues that affect individual users, who we **January 2026** +- `[F] [14th]`: Added :ref:`Batch Assessment Update ` to update assessment settings in bulk using a .xlsx file. - `[I] [7th]`: Add a way to :ref:`Enable or disable extensions on a course level `. **December 2025** diff --git a/source/instructors/setupcourses/batch-assessment-update.rst b/source/instructors/setupcourses/batch-assessment-update.rst new file mode 100644 index 00000000..a2a0c612 --- /dev/null +++ b/source/instructors/setupcourses/batch-assessment-update.rst @@ -0,0 +1,86 @@ +.. meta:: + :description: Batch Assessment Settings Update + + +.. _batch-assessment-update: + + +Batch Assessment Update +======================= + +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. + +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. + +Here is a sample screenshot of the template: + +.. image:: /img/guides/assessment-screenshot-XLSX-bulk-template.png + :alt: Sample XLSX Template + + +Important notes about the template: + - Edit only the white cells with dropdowns or number inputs. + - Leave any cell set to **No Change** to keep the current published setting. + - Gray cells labeled **Not Supported** or **Restricted** cannot be edited for the selected assessment type. + - Save the file in XLSX format before uploading. + + + +**Template field reference:** + + + +.. list-table:: + :header-rows: 1 + :widths: 20 30 50 + + * - Column + - Description + - Available Options + * - Assessment Type + - Type of assessment + - Predefined - cannot be modified + * - Points + - Point value for assessment + - Numeric value (e.g., 20, 50, 100) + * - Allow Partial Points + - Whether partial credit is allowed + - Yes, No, No Change, Not Supported + * - Use Maximum Score + - Whether to use maximum score + - Yes, No, No Change, Not Supported + * - Show Expected Answer + - When to show expected answer + - Always, Never, When Grades Are Released, No Change, Not Supported + * - Defined Number of Attempts + - Number of attempts allowed + - No, 1-9, No Change, Not Supported + * - Show Rationale to Student + - When to show rationale + - Always, Never, When Grades Are Released, Attempts, Score, No Change, Not Supported + * - Value (for ATTEMPTS/SCORE) + - Numeric threshold for Attempts or Score + - 1-99 (attempts), 0-100 (score %), blank otherwise + + +Once you have updated your Excel (.xlsx) template file, you are ready to bulk update the assessment settings. + + +To bulk update the assessment settings, follow these steps: + +1. On the **Courses** page, click the course you want to update the assessment settings for. + +2. Go to **Bulk Settings** area and scroll to the **Assessment Settings** section. + +3. In the **Assessment Settings** section click **Open updater**. + +4. Select or drag and drop the Excel (.xlsx) file in which you have defined all the required settings. + +5. Select the assignments you want to modify. + + .. image:: /img/guides/select-excel-batch-update.png + :alt: Select excel Batch Update + +6. Click **Apply and Close**. A popup window will appear asking you to confirm, click **Yes**. + +.. 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. \ No newline at end of file diff --git a/source/instructors/setupcourses/courses.rst b/source/instructors/setupcourses/courses.rst index 68fadf1f..d16cc14d 100644 --- a/source/instructors/setupcourses/courses.rst +++ b/source/instructors/setupcourses/courses.rst @@ -27,6 +27,7 @@ Courses Set Up bulk-assignment-update batch-groups-upload batch-student-tagging + batch-assessment-update add-teachers add-ta add-remove-students