--- title: "Grade history report" slug: "grade-history-report" tags: ["Totara Learn", "Content Creator", "Explainer", "How-to"] updated: 2025-07-22T10:52:18Z published: 2025-07-22T11:18:43Z 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-22T15%3A14%3A50Z&se=2026-11-22T16%3A14%3A50Z&sr=b&sp=r&sig=C8Jx6FleJOhDOOpEM7G3xvwCsBWh6s1Wa8KcdqgC%2FkA%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-22T15%3A14%3A50Z&se=2026-11-22T16%3A14%3A50Z&sr=b&sp=r&sig=kTX9hM36hF13SMrfoKj2g48VhDGHL%2FunyzWLV89faK8%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-22T15%3A14%3A50Z&se=2026-11-22T16%3A14%3A50Z&sr=b&sp=r&sig=ga8ReAyOWiUMsgja9WQZSdHog%2FKLvLk4Q0We6uKmLhk%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-22T15%3A14%3A50Z&se=2026-11-22T16%3A14%3A50Z&sr=b&sp=r&sig=9MlOeVlLlIPuqqHSn5PLrzWmHIbscA74g1jMBFh0TzU%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-22T15%3A14%3A50Z&se=2026-11-22T16%3A14%3A50Z&sr=b&sp=r&sig=hrVytgu%2FS5F4xLN7CK2rS8ihH8lpJ1bBZFl6OIeh4iI%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-22T15%3A14%3A50Z&se=2026-11-22T16%3A14%3A50Z&sr=b&sp=r&sig=uraJxtkbcDZRp3hY4uQpK4kdqYn5BUoK3IselgcgrnE%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](/19/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-22T15%3A14%3A50Z&se=2026-11-22T16%3A14%3A50Z&sr=b&sp=r&sig=DT3jpzcW2LX%2BsLftj3zOQ%2FeSbtKr7mWpElVGlnmRYxE%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.