{"id":5051,"date":"2023-04-03T16:19:18","date_gmt":"2023-04-03T20:19:18","guid":{"rendered":"https:\/\/learndash.com\/support\/docs\/add-ons\/gradebook-add-on\/"},"modified":"2025-06-19T11:46:37","modified_gmt":"2025-06-19T15:46:37","password":"","slug":"gradebook-add-on","status":"publish","type":"docs","link":"https:\/\/learndash.com\/support\/kb\/add-ons\/gradebook\/gradebook-add-on\/","title":{"rendered":"Gradebook Add-On"},"content":{"rendered":"\n

Easily customize, track, and share scores with Gradebook. Explore student progression and scores in simple, flexible gradebook tables, and share individual scores and progress with students and their parents.<\/span><\/p>\n\n\n\n

Installation<\/h2>\n\n\n\n

You can download the Gradebook Add-on plugin from account.learndash.com<\/a>. Simply log in to your account, download Gradebook, and follow the instructions below to install.<\/span><\/p>\n\n\n\n

To Install Gradebook:<\/span><\/p>\n\n\n\n

    \n
  1. Go to Plugins > Add New<\/li>\n\n\n\n
  2. Click Upload Plugin<\/li>\n\n\n\n
  3. Browse for and select the file that you downloaded after purchase. It will be in a <\/span>.zip<\/b> format<\/span><\/li>\n\n\n\n
  4. Click Install Now<\/li>\n\n\n\n
  5. Click Activate Plugin<\/li>\n<\/ol>\n\n\n\n

    How to Create a Gradebook<\/h2>\n\n\n\n

    You will need to create one or more gradebooks to use this plugin. Each gradebook can have customized settings.<\/span><\/p>\n\n\n

    \n
    \"How
    How to Create a Gradebook<\/figcaption><\/figure><\/div>\n\n\n

    <\/p>\n\n\n\n

      \n
    1. Go to LearnDash LMS > Gradebook<\/li>\n\n\n\n
    2. Click the Manage Gradebooks,then click Add New<\/li>\n\n\n\n
    3. Give your gradebook a Title<\/li>\n\n\n\n
    4. Select the Courses you want associated with this gradebook<\/li>\n\n\n\n
    5. Click Add Component. Give it a Name and select what you would like to be graded<\/li>\n<\/ol>\n\n\n\n

      (For example, if you want to award a grade for users who complete a their Assignments, you could create a Component, titled, say, Homework, and select Assignments.)<\/p>\n\n\n\n

        \n
      1. Lastly, customize the settings for the gradebook. Read through the customizations available below<\/li>\n<\/ol>\n\n\n\n

        Customization<\/h3>\n\n\n\n

        There are various settings you will need to customize for each gradebook.<\/p>\n\n\n\n

        Grading<\/h4>\n\n\n\n

        This Gradebook section determines what will go into factoring final user grades.<\/span><\/p>\n\n\n\n

        You must first select one or more Courses to be graded, or you can choose “All Courses.”<\/span><\/p>\n\n\n\n

        You may then add any number of Components. Each Component will have a grade calculated depending on what is inside it. Each Component grade will factor towards the gradebook final grade for each user. Some examples of Components would be Lessons, Quizzes, Semester 1, At Home Projects, etc.<\/span><\/p>\n\n\n\n

        Add any number of Quizzes, Assignments, Lessons, and Topics to each Component. You may also set the All Toggle to active, automatically including all current and future items. Be sure also to give each Component a name.<\/span><\/p>\n\n\n\n

        Weighting<\/h4>\n\n\n\n

        Though turned off by default, each gradebook can use a weighted grading system. You can toggle it on by clicking the toggle under “Enable Gradebook Weighting.” Once enabled, you will see a list of all Components you have created (if any) and input to enter a “Weight %.” Enter a percentage out of 100% for each Component so that all Components total 100%. Now each Component’s grade will only count for whatever weight you assign it when computing the final grade.<\/span><\/p>\n\n\n\n

        Settings<\/h4>\n\n\n\n

        Completion Grading is a setting you can modify that will determine how Lessons and Topics are graded. By default, this is set to “Only count on completion.” This means that if you have any Lessons and Topics inside any Components, they will only count toward the final grade once completed. At this point, they will receive 100% for each. If you change this setting to “Fail until completion,” each uncompleted Lesson and Topic will count as a failing grade at 0% until the user marks them complete. At this point, they will receive 100% for each. “Mark as Incomplete until completion” will set all Quizzes and Assignments as Incomplete until completion. Incomplete does not impact the Student’s Grade, but it will cause them to show as Incomplete within the Student’s Grades in the gradebook (Under “View\/Edit User Grades”) and within the Report Card.<\/span><\/p>\n\n\n\n

        Users<\/h4>\n\n\n\n

        This does not contain any settings, but it allows you to search for a user quickly, then click the “View\/Edit User Grades” to view or modify a user’s grades for the current gradebook.<\/span><\/p>\n\n\n\n

        Access and Manage Your Gradebooks<\/h3>\n\n\n\n

        This is where site admins, instructors, or anyone with proper access can view a snapshot of each gradebook’s grades.<\/span><\/p>\n\n\n\n

        To access and manage your gradebooks:<\/span><\/p>\n\n\n\n

          \n
        1. Go to LearnDash LMS > Gradebook<\/li>\n\n\n\n
        2. Under Gradebook, you can s<\/strong>elect a specific gradebook to view and edit.<\/span><\/li>\n<\/ol>\n\n\n\n

          Usage<\/h4>\n\n\n\n

          Each row in the table provides information about a single user and their overall grade and any other pre-defined Component grades. When more Components are added to each gradebook, they will show here respectively.<\/span><\/p>\n\n\n

          \n
          \"\"<\/figure><\/div>\n\n\n

          <\/p>\n\n\n\n

          Sorting<\/h4>\n\n\n\n

          Clicking on any column header will reload the page with all user results sorted by the selected column in ascending order, indicated by an upwards-facing triangle next to the column header. Clicking the same column header will reload the page with the results sorted in <\/span>descending<\/span><\/i> order.<\/span><\/p>\n\n\n\n

          Searching Users<\/h4>\n\n\n\n

          Use the user search in the top right to search through all users. This search field works like the default WordPress admin user search. You may enter a user ID, display name, login name, or even a user’s email.<\/span><\/p>\n\n\n\n

          Groups<\/h3>\n\n\n\n

          The gradebook allows you to filter the results by groups. Suppose you are an administrator of the website. In that case, you will be able to see all users without any group restrictions, and you will be able to view individual groups via the “Showing Gradebook for:” select box in the top left of the screen.<\/span><\/p>\n\n\n\n

          If you are a group leader that only belongs to 1 group, you will not see the dropdown, and you will only see users in your group. You can see a dropdown and switch groups if you are a leader of more than 1 group.<\/span><\/p>\n\n\n\n

          Disable Sorting by Grades for the Backend Gradebook<\/h3>\n\n\n\n

          If you have a slow-performing website or an extensive user base, and the gradebook will not load, try enabling “Disable Sorting by Grades for the Backend Gradebook” This will turn off some sorting features and grade snapshots within the gradebook, but will load significantly faster and more reliably on larger websites.<\/span><\/p>\n\n\n\n

          The setting for Disabling Sorting by Grades for the Backend Gradebook can be toggled on and off.<\/p>\n\n\n\n

          Note: If you are unable to even access the Settings page because the GradeBook page wont load, take your site address (lets say https:\/\/example.com<\/code>), figure out your WordPress admin base (most likely \/wp-admin\/<\/code>), and then append admin.php?page=learndash-gradebook-settings<\/code> (so, in our example, full URL would be https:\/\/example.com\/wp-admin\/admin.php?page=learndash-gradebook-settings<\/code><\/p>\n\n\n\n

          Alternatively, you can add: define( 'LD_GB_DISABLE_SORTING_BY_GRADES_BACKEND', true );<\/code> to your .\/wp-config.php file.<\/code><\/p>\n\n\n\n

          Report Card<\/h2>\n\n\n\n

          The Report Card is a presentational tool to give users information about their grades for a gradebook.<\/span><\/p>\n\n\n

          \n
          \"Report
          Report Card<\/figcaption><\/figure><\/div>\n\n\n

          <\/p>\n\n\n\n

          Display<\/h3>\n\n\n\n

          The report card contains information about the users overall grade, individual Component grades, and individual scores on various grade details. Clicking on any Component, or the arrow to the left will expand a breakdown of scores. Scores can be manual grades, quizzes, assignments, lessons, or topics.<\/span><\/p>\n\n\n\n

          Usage<\/h3>\n\n\n\n

          In order to use the report card, you must use the report card shortcode: <\/span>[ld_report_card gradebook=”1″]<\/p>\n\n\n\n

          Copy and paste this shortcode into any text that accepts shortcodes, the most common being the main content of any page or post. Replace the number 1 with the ID of the gradebook you want to show. You can also find the shortcode to copy when editing each gradebook.<\/span><\/p>\n\n\n

          \n
          \"Grade
          Grade Book Usage<\/figcaption><\/figure><\/div>\n\n\n

           <\/p>\n\n\n\n

          If you use the shortcode without a gradebook ID defined like <\/span>[ld_report_card] then it will attempt to show all relevant gradebooks for the user one after another.<\/span><\/p>\n\n\n\n

          You may also use the shortcode attribute <\/span>user to specify a specific user by the user’s ID. This will cause the report card to contain information about whatever user is supplied.<\/span><\/p>\n\n\n\n

          To find a user’s ID, go to the Users page in the WordPress administration area of the site and click on the username of whichever user you want to find the ID of. This will take you to the user edit page. You will see part of the URL that looks like <\/span>user_id=107<\/b>. The number is the user ID.<\/span><\/p>\n\n\n\n

          If you only want to show the Overall Grade (For instance, as part of a Certificate), you can use the <\/span>[ld_overall_grade] shortcode alternatively. The arguments are identical to those used in <\/span>[ld_report_card]; however, for the Overall Grade shortcode, the gradebook ID is required.<\/span><\/p>\n\n\n\n

          Assignments<\/h2>\n\n\n\n

          LearnDash can set a custom grade for assignments. By default, the grade of an assignment is assumed to be 100% unless modified.<\/span><\/p>\n\n\n\n

          Manual Grades<\/h2>\n\n\n\n

          Manual grades may be entered for users at any time. They are used to add any grade that a quiz or assignment cannot represent.<\/span><\/p>\n\n\n\n

          Accessing the Edit Screen<\/h3>\n\n\n\n

          To manage a user’s manual grades, you will need to access the gradebook user edit screen. This can be done either by clicking the View\/Edit User Grades” text in the User” column of the gradebook or by searching for a user and clicking “View\/Edit User Grades” from the gradebook edit screen.<\/span><\/p>\n\n\n\n

          Each row represents a grade. The icon on the left side represents each grade type. Hovering over the icon will reveal text to help identify it.<\/span><\/p>\n\n\n\n