---
title: "Grade calculation functions"
slug: "grade-calculation-functions"
tags: ["Totara Learn", "Content Creator", "Reference"]
updated: 2026-08-13T16:01:25Z
published: 2026-08-13T16:01:25Z
canonical: "totara.help/grade-calculation-functions"
---

> ## 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 calculation functions

There are a number of [grade calculations](/totara-20/docs/set-up-grade-calculations) supported in Totara Learn. Every calculation must start with an equals sign (**=**), and you can use commas (**,**) as a separator.

Certain language packs use different characters for some functions. These are as follows:

- **Separator**: English uses a comma (**,**) some other languages use a semicolon (**;**)
- **Decimal**: English uses a dot (**.**) some other languages use a comma (**,**)

| **Function** | **Example** | **Purpose** |
| --- | --- | --- |
| Average | =average([[item1]], [[item2]]...) | Shows the average of the grades included. |
| Maximum grade | =max([[item1]], [[item2]]...) | Shows the maximum (highest) grade in the list. |
| Minimum grade | =min([[item1]], [[item2]]...) | Shows the minimum (lowest) grade in the list. |
| Power | =power(base, power) | Raises a number to the power of another. |
| Round | =round(number, count) | Rounds a number to a predefined accuracy. |
| Sum | =sum([[item1]], [[item2]]...) | Returns the sum total all all items included in the list. |
| Multiple | =[[item1]]*[[item2]] | Multiples one item by another using an asterisk (*****) to represent a multiplication symbol. |
| Divide | =[[item1]]/[[item2]] | Divides one item by another, by using a forward slash (**/**) to represent divide symbol. |

A number of mathematical functions are also supported:

- sin
- sinh
- arcsin
- asin
- arcsinh
- asinh
- cos
- cosh
- arccos
- acos
- arccosh
- acosh
- tan
- tanh
- arctan
- atan
- arctanh
- atanh
- sqrt
- abs
- ln
- log
- exp

![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-03T21%3A39%3A17Z&se=2026-11-03T22%3A39%3A17Z&sr=c&sp=r&sig=aYjUY6uOpSFScULteEvSt0jHRe1jLVK42XjZBVEmC8g%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.