--- title: "Grade history report" slug: "grade-history-report" tags: ["Totara Learn", "Content Creator", "Explainer", "How-to"] updated: 2026-08-13T16:01:25Z published: 2026-08-13T16:01:25Z canonical: "totara.help/grade-history-report" --- > ## Documentation Index > Fetch the complete documentation index at: https://totara.help/llms.txt > Use this file to discover all available pages before exploring further. # Grade history report The grade history report allows you to view a detailed list of all grade actions taken within a course for either a specific learner, grade item, or taken by a particular trainer. ## Using the grade history report The report can be accessed by clicking on *Grades > Grade history* in the **Administration** block on the course page. You can also select **Grade history** from the dropdown menu when viewing any other grade report on a course. You can then set a number of parameter by which to generate the report, these include: - **Select users**: If you want to only see information for selected learners - **Grade item**: Shows only information on a particular grade item - **Grader**: Displays only grade actions taken by a particular trainer - **Date from**/**date to**: To only show data from a particular date range - **Revised grades only**: Displays only grade which have been changed To generate a report: 1. Go to *Grades > Grade history* in the **Administration** block. 2. Set your desired parameters. 3. Click **Submit**. ![Grade history report settings.](https://cdn.document360.io/a007399b-031e-436b-999a-528240e16f58/Images/Documentation/image-1635176878762.png?sv=2026-02-06&spr=https&st=2026-11-04T00%3A38%3A38Z&se=2026-11-04T01%3A38%3A38Z&sr=c&sp=r&sig=FR7xb6LOHKQkbUm4r%2Fof%2FnZ7SjthhfLKdkjA%2B%2BCbQgw%3D) ### Exporting Once you have generated a report you can export the results as one of the following formats: - Comma separated values (.csv) - Excel spreadsheet (.xls) - HTML table - Javascript Object Notation (.json) - OpenDocument (.ods) Exporting could be useful if you wish to use or store the data offline as well as for sharing with others. ### Filtering results Each of the columns in the results table can be hidden (![Hide a column using the minus icon.](https://cdn.document360.io/a007399b-031e-436b-999a-528240e16f58/Images/Documentation/image-1635176563363.png?sv=2026-02-06&spr=https&st=2026-11-04T00%3A38%3A38Z&se=2026-11-04T01%3A38%3A38Z&sr=c&sp=r&sig=FR7xb6LOHKQkbUm4r%2Fof%2FnZ7SjthhfLKdkjA%2B%2BCbQgw%3D)) and shown (![Show a column using the plus icon.](https://cdn.document360.io/a007399b-031e-436b-999a-528240e16f58/Images/Documentation/image-1635176563384.png?sv=2026-02-06&spr=https&st=2026-11-04T00%3A38%3A38Z&se=2026-11-04T01%3A38%3A38Z&sr=c&sp=r&sig=FR7xb6LOHKQkbUm4r%2Fof%2FnZ7SjthhfLKdkjA%2B%2BCbQgw%3D)) to help you see the information you want. Clicking on a column title will sort the data by ascending (![Sort by ascending order.](https://cdn.document360.io/a007399b-031e-436b-999a-528240e16f58/Images/Documentation/image-1635176563407.png?sv=2026-02-06&spr=https&st=2026-11-04T00%3A38%3A38Z&se=2026-11-04T01%3A38%3A38Z&sr=c&sp=r&sig=FR7xb6LOHKQkbUm4r%2Fof%2FnZ7SjthhfLKdkjA%2B%2BCbQgw%3D)) or descending (![Sort by descending order. ](https://cdn.document360.io/a007399b-031e-436b-999a-528240e16f58/Images/Documentation/image-1635176563429.png?sv=2026-02-06&spr=https&st=2026-11-04T00%3A38%3A38Z&se=2026-11-04T01%3A38%3A38Z&sr=c&sp=r&sig=FR7xb6LOHKQkbUm4r%2Fof%2FnZ7SjthhfLKdkjA%2B%2BCbQgw%3D)) order. To remove any sorting and return the table to the default view click **Reset table preferences** located to the top right of the table. ![Using reset table preferences to remove any filtering.](https://cdn.document360.io/a007399b-031e-436b-999a-528240e16f58/Images/Documentation/image-1635176843424.png?sv=2026-02-06&spr=https&st=2026-11-04T00%3A38%3A38Z&se=2026-11-04T01%3A38%3A38Z&sr=c&sp=r&sig=FR7xb6LOHKQkbUm4r%2Fof%2FnZ7SjthhfLKdkjA%2B%2BCbQgw%3D) ## Administration settings As a Site Administrator you can customise how long the grade history is kept for by setting the **Grade history lifetime** by going to *Quick-access menu >* *Server > Cleanup*. See the [Server page](/totara-20/docs/server) for more information. Under *Quick-access menu >* *Grades > Report settings > Grade history* you can configure the **History entries per page** setting, which controls how many records are shown on a single page of the report. ![Course badge](https://cdn.document360.io/a007399b-031e-436b-999a-528240e16f58/Images/Documentation/course-badge_grading-completion-and-certificates.svg?sv=2026-02-06&spr=https&st=2026-11-04T00%3A38%3A38Z&se=2026-11-04T01%3A38%3A38Z&sr=c&sp=r&sig=FR7xb6LOHKQkbUm4r%2Fof%2FnZ7SjthhfLKdkjA%2B%2BCbQgw%3D)The Totara Academy has a whole course dedicated to using [Grading, completion, and certificates](https://totara.community/course/view.php?id=646) in Totara Learn. Here you can learn more on how to use these tools, see best practice, and give it a go yourself. Join the [Totara Community](https://totara.community/) for more resources to help you get the most out of Totara. © Copyright 2025 Totara Learning Solutions. All rights reserved. Some content originally obtained via [GPLv3 license](https://www.gnu.org/licenses/licenses.html#GPL) and continues to be available under GPLv3. All other content is the sole copyright of Totara Learning Solutions.