# Grades

{% embed url="<https://youtu.be/OfDtaP-u6SE>" %}

**The Grades** add-on makes it easier for teachers to check students' work. It enables one to evaluate quizzes and assignments with different types of grades (letters, points, or percents) and see all the grades in one place. This helps instructors keep track of how well students are doing in the course and increases engagement among students.

## **Why You Need Grades in Your LMS?**

* **Efficient Grading ⚡️:** The add-on streamlines the grading process, saving instructors valuable time.
* **Personalized Feedback 📝:** Teachers can provide tailored feedback to each student, enhancing the learning experience.
* **Centralized Gradebook 📊:** All grades are accessible in one place, making it easy to monitor student progress.
* **Improved Student Engagement 🚀:** Timely feedback and clear grading criteria motivate students to strive for excellence.

***

To enable the add-on simply follow **WP Dashboard > MS LMS > Pro Addons > Grades** and enable the toggle:

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2F1W6OlQlnLz29EJZzqpLD%2Fimage.png?alt=media&#x26;token=892a8b9a-284d-4927-b7d6-5301e310dcfc" alt=""><figcaption><p><strong>WP Dashboard > MS LMS > Pro Addons > Grades</strong></p></figcaption></figure>

## Grades Overview

Students will get grades for each of their completed [**assignments** ](https://docs.stylemixthemes.com/masterstudy-lms/lms-pro-addons/assignments)and [**quizzes**](https://docs.stylemixthemes.com/masterstudy-lms/lms-course-features/quizzes). After the course completion, their grade will be visible to them on the [**Single Course Page**. ](#course-grades)&#x20;

That's why we can divide the feature into:

* [**Assignments & Quizzes Grades**](#assignments-and-quizzes-grades)
* [**Course Grade**](#course-grade)

{% hint style="info" %}
Settings for the grades [**can be configured**](#grades-addon-settings) in MS LMS Settings.&#x20;
{% endhint %}

### Assignments & Quizzes Grades

This type of grade will be displayed in the[ **course player**](https://docs.stylemixthemes.com/masterstudy-lms/lms-settings/course-player) and in the **grade details pop-ups.**&#x20;

{% tabs %}
{% tab title="in Course Player" %}

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2FXnN4Fb4eCyzomVRbHYbn%2Fimage.png?alt=media&#x26;token=a98055b7-be5c-4066-bafc-418fe9ab3e16" alt=""><figcaption><p>View as a Student</p></figcaption></figure>
{% endtab %}

{% tab title="in Single Course Page" %}

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2FlthS1CUs6K8a7sCTNvyI%2Fimage.png?alt=media&#x26;token=55a76fa2-2c5c-44c5-9906-a9cc0abd56b6" alt=""><figcaption><p>View as a Student</p></figcaption></figure>
{% endtab %}
{% endtabs %}

Instructors can set the **passing grades** for [**assignments** ](https://docs.stylemixthemes.com/masterstudy-lms/lms-pro-addons/assignments)and [**quizzes** ](https://docs.stylemixthemes.com/masterstudy-lms/lms-course-features/quizzes)right on the course builder:

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2FSXGnPlREvlmA6CphOu5E%2Fimage.png?alt=media&#x26;token=652ca4d0-6c1d-4050-849e-b13be7dbe741" alt=""><figcaption><p>Course Builder</p></figcaption></figure>

By clicking the <mark style="color:purple;">**See Table**</mark> button, you can see the [**Grades table**](#grades-table) as well:

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2FQ02wdiH3yUdQuAqGybdq%2Fimage.png?alt=media&#x26;token=495566fa-706d-40fd-bf1b-196b2fd10ba0" alt=""><figcaption><p>Course Builder</p></figcaption></figure>

{% hint style="danger" %}
If the Grades Addon is **disabled**, assignments will have only <mark style="color:green;">**Passed**</mark> and <mark style="color:red;">**Failed**</mark> statuses only. But in case you have decided to use Grades Addon, these assignments' results will be displayed in **grades** (points, percents, letter grades, [**etc**](#result-display)).

***

Because of this, if you have previously evaluated assignments before enabling the addon, their statuses will be changed in this format:

* <mark style="color:green;">**Passed**</mark>**&#x20;-> 100% (or&#x20;**<mark style="color:green;">**highest**</mark>**&#x20;grade)**
* <mark style="color:red;">**Failed**</mark>**&#x20;-> 0% (or&#x20;**<mark style="color:red;">**lowest**</mark>**&#x20;grade)**
  {% endhint %}

### Course Grade

**Course grade** is the **average grade** of the assignment and quiz results. The system weights each of  them equally and calculates the Course Grade by following the formula:

$$
Course Grade = \frac{\sum(Assignments\&Quizzes )}{NumberOfAssignments\&Quizzes}
$$

The **Course Grade** can be checked in the **My Grades** tab of the **Students Dashboard:**

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2FyHWOXC91jgR7mqHW0YLv%2Fimage.png?alt=media&#x26;token=cd55394f-cb86-484f-8ec9-ba28599b025d" alt=""><figcaption><p>View as a Student</p></figcaption></figure>

Here you can find the Grades for all of the enrolled courses. There is also availability to get the data for the specific period using a date picker and the search fields:

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2F0C95yGexsA1uEX3lAUqx%2Fimage.png?alt=media&#x26;token=2c23a4e2-f6c9-4f74-be9c-3fdc64fb84d5" alt=""><figcaption><p>View as a Student</p></figcaption></figure>

By clicking any of the courses, students can get the detailed **Grade Info:**

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2Fjy8t9jJKJfzZvzRAnql4%2Fimage.png?alt=media&#x26;token=ee41cfaf-e531-46d1-900c-31293df017d4" alt=""><figcaption></figcaption></figure>

Admin and Instructors can also get this info in their dashboards:

{% tabs %}
{% tab title="Grade Details as Admin (Backend)" %}

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2Fb5M3NS0HSKIGJogylecg%2Fimage.png?alt=media&#x26;token=2ccff5ce-8259-4cad-b8db-257bd7636398" alt=""><figcaption><p>WP Dashboard > Grades</p></figcaption></figure>
{% endtab %}

{% tab title="Grade Details as Instructor (Frontend)" %}

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2FTZSB56wdi6GDA5i6iVoV%2Fimage.png?alt=media&#x26;token=c9ed8787-64d0-422b-98c8-b50b6403fe16" alt=""><figcaption><p>Instructors Dashboard</p></figcaption></figure>
{% endtab %}
{% endtabs %}

## Grades Addon Settings

You can access the Grades settings by following **WP Dashboard > MS LMS > Settings > Grades** or clicking the **gear**  :gear: **icon on** the **Pro Addons Page:**

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2FmkKGzpFEmeOurPfmNMju%2Fimage.png?alt=media&#x26;token=6679a4f3-31d5-4ddb-9319-c95397a9b016" alt=""><figcaption><p> <strong>WP Dashboard > MS LMS > Settings > Grades</strong></p></figcaption></figure>

### Result Display

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2FKnrlXpDPK1F8o8Gy6srU%2Fimage.png?alt=media&#x26;token=56fa8a2a-f5cb-442e-81c5-ed44d59de1c0" alt=""><figcaption></figcaption></figure>

**Result Display** setting enables to display of the grade scores of the student in one of the three available formats:

{% tabs %}
{% tab title="Grade" %}

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2FXnN4Fb4eCyzomVRbHYbn%2Fimage.png?alt=media&#x26;token=a98055b7-be5c-4066-bafc-418fe9ab3e16" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Point" %}

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2FgHZq120XxTgVbCrdCsEW%2Fimage.png?alt=media&#x26;token=58dd57f5-4ca6-492c-aa85-8a787a615b07" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Percent (%)" %}

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2FlVfsVHUwQg8uGbLcC53d%2Fimage.png?alt=media&#x26;token=8fd76c1f-9803-4275-b860-38a02b889372" alt=""><figcaption><p>Grade</p></figcaption></figure>
{% endtab %}
{% endtabs %}

### Score Separator

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2Ft3rTPm3kc19qRh3djqYt%2Fimage.png?alt=media&#x26;token=41d6508f-c9e3-4466-a2d8-0c3f4cfe88ef" alt=""><figcaption></figcaption></figure>

**Score Separator** is the symbol or text used to separate the score from the maximum value. This symbol is used wherever the **current score** of the student is displayed, **along with the maximum value** of the quiz or assignment.&#x20;

{% tabs %}
{% tab title="Score Separator in Grades Tab" %}

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2FfRLlpkfnIG52qnLVrdyc%2Fimage.png?alt=media&#x26;token=1639e564-63d4-4769-bfed-bbe1233452b2" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Score Separator in Grade Details" %}

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2F8Wq3W0emJgTWHQqBTMPa%2Fimage.png?alt=media&#x26;token=f9d24d6c-44c9-4e12-993e-29d6dd99dc66" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### Grades Display on Course Page

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2FR3dxEIWPmsSRqFEu3DV0%2Fimage.png?alt=media&#x26;token=09d1652e-f749-430f-b5dc-bf4862eaaaf1" alt=""><figcaption></figcaption></figure>

This setting enables you to control the display of the **Course Grade** in the[ **Single Course Page**](https://docs.stylemixthemes.com/masterstudy-lms/lms-settings/course). Choose one of the available ways you want to display the grade:

{% tabs %}
{% tab title="Show as a separate tab" %}

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2FVgl5aVCHbVjUVdBZX2yC%2Fimage.png?alt=media&#x26;token=f39130e9-42d2-4120-9894-76db9ab4fa72" alt=""><figcaption><p>View as a Student</p></figcaption></figure>
{% endtab %}

{% tab title="Show in Sidebar" %}

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2FgZvvm8GlTalBUu2ZdivP%2Fimage.png?alt=media&#x26;token=3ebdf489-c0bd-4a4a-b639-062894aa06f7" alt=""><figcaption><p>View as a Student</p></figcaption></figure>
{% endtab %}
{% endtabs %}

**Grade Details** can also be viewed here as well:

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2FTogrXppvYTzeX2KDJbJZ%2Fimage.png?alt=media&#x26;token=2d85b04c-730d-4fb7-a2f5-2bf0f0857cd5" alt=""><figcaption><p>View as a Student</p></figcaption></figure>

### Grades Table

This is the place where you have to define the available grades in your LMS. You can design any grading system according to your needs. Initially, the Grades Table will come with the following predefined grades.&#x20;

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2FuNnvySrZFXo8xMUTkVMC%2Fimage.png?alt=media&#x26;token=1a5469bb-ff7d-4a1f-8ffb-7475b9b7e995" alt=""><figcaption></figcaption></figure>

* **Grade Name** - the label of the grade, represented in letters and symbols
* **Grade Point** - numerical value corresponding to the grade on a point scale
* **Grade Range** - the percentage interval that defines the scores required for a student to receive a specific grade

#### How to Add  New Grades?

You can add new grades at the bottom of the [**Grades Table:**](#grades-table)

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2FbZs5E5g5cszVEvkgdIOM%2Fimage.png?alt=media&#x26;token=bc1f0fcb-964e-40c6-9a23-9a797d98e442" alt=""><figcaption></figcaption></figure>

* **Grade Point** - numerical value corresponding to the grade on a point scale
* **Grade Name** - the label of the grade, represented in letters and symbols
* **Grade Range min, %** - specify the minimum range value for the new grade
* **Color** - select the color for the grade using the RGBA color picker

If you want to add new grades to the existing [**Grades Table**](#grades-table), there is only one rule you have to follow:

{% hint style="info" %}
The minimum range must be less than the previous one. In other words, Grades will always be entered in descending order.
{% endhint %}

Let's assume we have a C grade at the bottom of our grades table. It means C is the lowest grade in our LMS. But we want to add a C- grade as well.

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2Fyk9g11ihVsRRFp0mCo2T%2Fimage.png?alt=media&#x26;token=3ce227f2-6bfc-4330-86c1-cdf83f4b7e18" alt=""><figcaption></figcaption></figure>

As you see from the picture, **30%** is the minimum range value for the grade C. So the minimum range of our new grade should be less than 30.  After filling required fields, click on the <mark style="color:purple;">**Add**</mark> button to add the grade.

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2Fm2dgm1icWMZwD6p8K9wI%2Fimage.png?alt=media&#x26;token=dd6a7f9b-cbde-49c3-9360-ff83dee8a4f5" alt=""><figcaption></figcaption></figure>

You can delete the last grade in the table using the trash 🗑 button:

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2Fm6yAMPUrVl6rJlAgjN3r%2Fimage.png?alt=media&#x26;token=ab3e9f71-eb63-4c00-9eb8-b4cf0a700539" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
You **cannot delete** or **edit** grades **except for the last one**. To edit a grade that is not the last one, you must first delete the grades after it, making the grade you want to edit the most recent (last). Once you've made the desired changes, you can re-add the deleted grades.
{% endhint %}

## Regenerate Grades

In case there are changes in assignments or quiz results for the student, his course grade should be regenerated. This can be done by the [**admin**](#regenerate-grades-as-admin), [**instructor**](#regenerate-grades-as-instructor)**,** or even by [**the student**](#regenerate-grades-as-student) himself.&#x20;

Let's see some example cases:

> **CASE 1: Student Improved His Results**
>
> Let's assume student got B+ grade and he already completed the course and got his certificate. But he wanted to improve his results and retook the quiz(zes)/assignment(s). After that Regenerating Grades action should be taked to change the final Course Grade for the selected student.&#x20;

> **CASE 2: New Assignments or Quizzes Added**
>
> If there are new assignments or quizzes available in the course, but the student has already completed the course, these quiz or assignments do not impact to the student's grade. However, if he returns and starts to learn new course materials, the course grades can be regenerated.&#x20;

{% hint style="info" %}
Actually, Grades can be **regenerated anytime**, there is nothing to lose in doing it. &#x20;

***

However, grades can not be manually entered or modified by admins or instructors in MasterStudy LMS! They are **automatically calculated** and can only **be regenerated.**
{% endhint %}

### Regenerate Grades as Admin

To regenerate grades as admin, open the Grades tab in the WordPress Dashboard:

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2F6YEw0jI2yznBuU2x2XxR%2Fimage.png?alt=media&#x26;token=8ce80aa1-384c-4b87-b0f7-6e340250599d" alt=""><figcaption></figcaption></figure>

Choose the student and his enrolled course to open the grade details, then click on the <mark style="color:purple;">**Regenerate Grades**</mark> button:

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2FHn5ptkZNf4RtlFoWkU1k%2Fimage.png?alt=media&#x26;token=d30e29f3-3b21-41de-a6c6-c64f25f47d55" alt=""><figcaption></figcaption></figure>

### Regenerate Grades as Instructor

Instructors can regenerate grades for their students in the **Grades** tab of the **instructors' dashboard**:

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2F8ibtpySwysHI4xM7JVVB%2Fimage.png?alt=media&#x26;token=86bd486e-34ef-4b57-9ac9-b7fc90d5581c" alt=""><figcaption></figcaption></figure>

Choose the student and his enrolled course to open the grade details, then click on the <mark style="color:purple;">**Regenerate Grades**</mark> button:

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2F2krSL4mNtD7dqaVGeViK%2Fimage.png?alt=media&#x26;token=4b47666d-9bce-406f-9c12-3b0b19eb1ffc" alt=""><figcaption></figcaption></figure>

### Regenerate Grades as Student

Like Instructors and admin, students can also regenerate their grades from their dashboard:

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2FyHWOXC91jgR7mqHW0YLv%2Fimage.png?alt=media&#x26;token=cd55394f-cb86-484f-8ec9-ba28599b025d" alt=""><figcaption><p>View as a Student</p></figcaption></figure>

Click on the desired course to open the Grade Details and click on the <mark style="color:purple;">**Regenerate Grades**</mark> button:

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2Fsht3HN7yOxT5m3ZDjUme%2Fimage.png?alt=media&#x26;token=dfc3d3d2-ac57-4b1e-ab0e-b8a1eb5fbf7e" alt=""><figcaption></figcaption></figure>
