---
title: "Import grades"
slug: "import-grades"
tags: ["Totara Learn", "Site Administrator", "How-to"]
updated: 2026-08-13T16:01:25Z
published: 2026-08-13T16:01:25Z
canonical: "totara.help/import-grades"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://totara.help/llms.txt
> Use this file to discover all available pages before exploring further.

# Import grades

You can import grades from outside the system in one of three ways:

- CSV files
- XML file
- Directly (pasting from a spreadsheet)

## Import from CSV files

If you wish to import your grades from a CSV file then follow these steps:

1. From the course you want to upload them to go to *Grade administration > Import > CSV file.*
2. Upload the file and configure the [settings](/totara-20/docs/grade-import-settings).
3. Click **Upload grades**.

## Import from XML file

If you wish to import your grades from a XML file then follow these steps:

1. From the course you want to upload them to go to *Grade administration > Import > XML file.*
2. Upload the file and configure the [settings](/totara-20/docs/grade-import-settings).
3. Click **Upload grades**.

## Pasting from spreadsheet (direct import)

If you wish to import your grades by pasting them directly from a spreadsheet then follow these steps:

1. From the course you want to upload them to go to *Grade administration > Import > Paste from spreadsheet.*
2. Paste the grade data and configure the [settings](/totara-20/docs/grade-import-settings).
3. Click **Upload grades**.

![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-03T17%3A39%3A52Z&se=2026-11-03T18%3A39%3A52Z&sr=c&sp=r&sig=tasvGFg2zHbAvtHH6ERyJK65lQaLiCXGahEOJ8MXojY%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.