We are thrilled to introduce ‘GPA & Credits’ setup, making it easier for you to evaluate your students’ performance using these metrics. As an admin, you can now configure GPA calculations, define subject credits, and ensure a seamless integration of these metrics in student Transcripts.
This article covers:
Setting up GPA & Credits in the Academic setup
Including GPA & Credits in Transcripts
Let’s dive into the details!
Setting up GPA & Credits in the Academic setup
From the Admin portal, go to ‘Programme level configurations’ in your preferred curriculum and navigate to the ‘Academic setup’.
Inside the ‘Academic setup’, you will find a new ‘GPA & Credits’ tab in the left panel. This setting will allow you to configure GPA calculations and subject credits for your programme.
GPA
Inside the ‘GPA & Credits’ section, you will first land on the ‘GPA’ page, where you can configure how GPA will be calculated.
To begin, enable the ‘Calculate GPA’ option if you would like to calculate GPA for students enrolled in the selected curriculum.
Once enabled, you will see the following settings to define how GPA is calculated:
GPA calculation method – This setting lets you decide how the overall GPA will be calculated.
Grade point calculation method for subjects – Using the option, you can define how individual subject grades/scores will be converted into grade points.
GPA scale definition – Using this setting, you can define a conversion scale for GPA, determining how scores or grades convert into GPA values.
Additional settings – Under the ‘Additional settings’ section you can configure which subjects will be included in the GPA calculation for each grade and assign added value to subjects based on their difficulty level to adjust their contribution to the overall GPA.
GPA calculation method
The ‘GPA calculation method’ determines how a student's overall GPA is derived based on their grade points in each subject. By default, the ‘Simple (without credits)’ method is selected. To modify this, click on the ‘pencil icon’ highlighted in the screenshot below.
As you click the pencil icon, a modal will open up where you can select one of the two methods:
1. Simple (without credits)
The ‘Simple (without credits)’ method calculates GPA by averaging all subject grade points, treating each subject equally. Grade points for each subject are derived based on the defined Grade point conversion (GPA) scale. This method does not factor in subject credits, so every subject carries the same weight in the final GPA, regardless of its complexity or instructional hours. This method is useful when all subjects are considered equally important in assessing a student's overall performance.
2. Weighted (with credits)
The ‘Weighted (with credits)’ method calculates GPA by incorporating subject credits, ensuring that subjects with higher credit values have a greater impact on the final GPA. Instead of treating all subjects equally, the grade points are adjusted based on the assigned credits, giving more weight to subjects that require more effort or instructional time. The system derives grade points for each subject based on the defined GPA scale and takes credits from the values you assign in the ‘Credits’ section. This approach provides a more precise representation of student performance, especially when different subjects carry varying levels of academic weight.
By selecting the appropriate method, you can decide whether all subjects should contribute equally to GPA or if certain subjects should have a greater weightage based on their credit value.
Once you select your method of GPA calculation, click on the ‘Save’ button to proceed.
Grade point calculation method for subjects
The ‘Grade point calculation method for subjects’ determines how subject scores/grades are converted into grade points, which contribute to the overall GPA. To modify this, click on the 'pencil icon' highlighted in the screenshot below.
A modal will appear where you can choose one of the two conversion methods: ‘Percent score to grade point’ or ‘IB grade to grade point’.
💡Please note that the ‘IB grade to grade point’ method is only available for IBMYP and IBDP curricula. If your school follows a different curriculum, this option will not be visible.
Let’s explore each conversion method in detail.
1. Percent score to grade point
The ‘Percent score to grade point’ method converts percentage scores into grade points using a predefined scale. You can convert percentages into grade points in two ways:
Using a defined scale – Allows mapping percentage ranges to specific grade points. You can set custom thresholds for different grade point values.
Automatic conversion – Directly multiplies the percentage score by the maximum possible GPA to determine the grade point. This method provides a straightforward, formula-based approach to conversion.
2. IB grade to grade point
The ‘IB grade to grade point’ method directly converts IB grades (on a scale of 1 to 7) into grade points using a predefined mapping. You can configure the conversion scale, ensuring that each IB grade corresponds to a specific grade point value.
By selecting the appropriate method, you can align grade point calculations with your school’s academic policies. Once you have selected your preferred method of calculation, hit the ‘Save’ button to proceed.
GPA scale definition
The ‘GPA scale definition’ converts scores or grades into grade points. To set up the GPA scale, click on ‘Define scale’ under this section.
As you click on ‘Define scale,’ the available options will adjust based on the selected ‘Grade point calculation method for subjects.’ Here’s how the configuration works for each method:
1. Percent score to grade point (Using a defined scale)
If you have chosen to convert percentage scores to grade points, you will need to create a conversion scale that maps percentage ranges to grade points. To setup a scale, follow the steps below:
Enter a score threshold (e.g., 90% or higher) and assign a corresponding grade point.
Add multiple ranges by clicking ‘+ Add another’ button to create a detailed mapping.
If needed, you can also delete specific entries using the trash icon.
Click ‘Save’ once all mappings are defined.
This method allows you to establish a custom grading scale that aligns with your school’s academic policies.
2. Percent score to grade point (Automatic conversion)
With the automatic conversion method, the system calculates grade points by multiplying the percentage score by the maximum GPA value. To use this method, simply enter the highest possible GPA value (e.g., 4.0) in the GPA scale field, and the system will automatically convert scores without needing a manually defined scale.
This method is useful for straightforward conversions where a percentage directly corresponds to a grade point.
3. IB grade to grade point
If the ‘IB grade to grade point’ method is selected, the scale definition will allow mapping IB grades (1–7) to grade points. To setup a scale, follow the steps below:
Assign a grade point value to each IB grade (e.g., IB grade 7 = 4.0).
Adjust values as needed and click ‘Save’ once done.
This ensures that IB grades are converted correctly based on your school-specific GPA requirements.
You can edit an existing GPA scale anytime by clicking the ‘Edit’ button next to the defined scale.
💡Please note that if you change the ‘Grade point calculation method for subjects’ after defining your scale, you will need to add values for the new scale if it was not previously defined.
Additional settings
Under the ‘Additional settings’ section, you will find two customization options for GPA calculation:
Include/exclude subjects from GPA – This option allows admins to select which subjects will contribute to the GPA for each grade.
Define added value for subjects – You can use this option to assign additional weight to certain subjects based on their difficulty level.
Let’s explore each one of these settings in detail.
1. Include/exclude subjects from GPA
Inside the ‘Include/exclude subjects from GPA’ setting, all subjects are included by default in the GPA calculation. You can modify this by selecting which subjects should or should not contribute to the GPA for each grade by clicking on the ‘Edit’ button in the top right corner.
Simply deselect the subjects you don’t wish to include in the GPA calculation.
Once you have made the necessary changes, click ‘Save’ to apply the updates and exit the setting.
2. Define added value for subjects
The ‘Define added value for subjects’ setting allows you to assign additional weight to certain subjects based on their difficulty level. Some subjects may require extra effort or be considered more academically challenging, and this setting ensures that their contribution to the GPA is adjusted accordingly. To modify this, click on the ‘Edit’ button and assign a weight or added value to specific subjects to increase their impact on the overall GPA. Here’s an example of how the added value is included when the GPA calculation takes place:
Suppose, your GPA scale defines that a score between 90–100% corresponds to a grade point of 4.0, and the subject ‘Digital society’ has an added value of 0.5, then a student who scores 92% in ‘Digital society’ will have their grade point adjusted as follows:
92% → 4.0 grade point → 4.0 + 0.5 (added value for Digital society) → Final grade point = 4.5
Once done, click ‘Save’ to confirm the changes.
💡Please note that anywhere you see data grids on Toddle’s platform, they function just like spreadsheets — you can drag to select entire columns for bulk input or use your keyboard to navigate across cells. Additionally, this screenshot is from the IBDP curriculum, which is why you see a filter for ‘Levels’, and ‘Added value (SL)’ and ‘Added value (HL)’ columns. In other curricula, these columns will be replaced by all the classes/grades in that programme. If a column appears greyed out, it means the subject is not mapped to that specific level, class, or grade. Lastly, the ‘Subject groups’ filter is available only for the IBDP and IBMYP curricula.
Credits
Switch over to the ‘Credits’ section from the left pane. Credits represent the value assigned to each subject, determining the impact of grade points(GPs) on the overall GPA. Remember that higher credit values indicate that a subject carries more significance in GPA calculations.
Here, you will find two settings:
Calculate credits – Use this to enable or disable the use of credits for subjects by toggling the setting on or off.
Define subject credits – Assign specific credit values to each subject to reflect their relative importance in GPA calculations.
💡Please note that you can enable ‘Credits’ regardless of the selected GPA calculation method. However, credits will only affect the GPA if you choose the ‘Weighted (with credits)’ calculation method.
Click on the arrow against the ‘Define subject credits’ section to go inside it.
Define subject credits
Inside the ‘Define subject credits’ section, you can assign grading period-wise credits for each subject across grades.
Here, you can configure credits for each grade separately by switching between grades from the side pane on the left. By default, each subject is assigned a credit value of 1 for each grading period. To modify credit values, click on the ‘Edit’ button at the top. Columns that are greyed out and cannot be edited represent cumulative grading periods, where credit values are automatically calculated. The system adds the credit values from all grading periods mapped to a cumulative period to determine its total credit value. The ‘Total credit’ column shows the sum of all credit values assigned to individual reporting periods, excluding cumulative grading periods.
Once you have modified the credit values, click on ‘Save’ to finalize them.
💡Please note that anywhere you see data grids on Toddle’s platform, they function just like spreadsheets; you can drag to select entire columns for bulk input or use your keyboard to navigate across cells.
Disabling credits
Incase you toggle off the option to display credits while using the ‘Weighted (with credits)’ GPA calculation method, a confirmation pop-up will appear, informing you that this action will switch the GPA calculation method to ‘Simple (without credits).’ This means subject weightage will no longer be factored into GPA calculations. You can either select ‘Cancel’ to keep credits enabled or ‘Disable’ to proceed with turning them off.
Including GPA & Credits in Transcripts
Once you’ve completed the ‘GPA & Credits’ setup in the ‘Academic setup’, navigate to the ‘Transcripts’ module under School-wide configurations to see how GPA and credits are reflected in transcripts.
Inside the ‘Transcripts’ module, GPA and credits-related updates will reflect in three key areas:
The transcript template, where you can enable and customise how GPA, grade points, credits, and quality points appear.
The data import process, where you can pull data from progress reports or upload a CSV file.
The generated transcript, where these fields and their aggregates (like totals, averages, and GPA) will be displayed for each student.
Here’s a brief overview of the GPA and credits related fields that have been added in Transcripts:
Grade point: Displays the grade point value a student has earned for a subject. The conversion from scores or grades follows the ‘GPA scale definition’ set in the Academic setup.
Credits: Shows the total number of credits a student receives for each subject, based on the grading period(s) the transcript is generated for.
Grade point average (GPA): Displays the calculated GPA for the grading period(s) included in the transcript. GPA is always calculated based on the selected method in the Academic setup, even if some GPA or credit-related fields are hidden in the transcript. For example, if ‘Weighted (with credits)’ is selected as the GPA calculation method, credits will still be factored into the GPA calculation, even if they are not displayed in the transcript.
Quality points: Represents the points obtained in each subject by multiplying subject grade points by assigned credits.
💡Please note that 'Grade point' and 'GPA' will appear in the transcript only if the 'Calculate GPA' option is enabled in the Academic setup. 'Credits' will be available as a criterion when the 'Calculate credits' option is enabled. 'Quality points' will be displayed only if both GPA and Credits are enabled.
To begin reviewing or updating how GPA and credits are reflected in transcripts, click the ‘Edit template’ button in the top-right corner.
💡Please note that along with the GPA and credits-related updates, a few minor updates have also been made to the transcript template, which we will cover in the following section.
Transcript template
Inside the transcript template, you’ll find the same core sections as before - ‘Transcript header’, ‘Student details’, ‘Programme settings’, and ‘Signatories’, and the option to create custom sections using the ‘Add section’ button.
You’ll see new updates within the ‘Student details’ and ‘Programme settings’ sections. Let’s take a closer look at what has changed in each of these sections.
Student details
In the ‘Student details’ section, the fields remain the same as before. However, you can now customise the order in which these fields appear in the transcript using the six-dot menu beside each field. And, there is a new option to rename any field to match your school’s terminology by clicking the pencil icon.
Programme settings
Inside the ‘Programme settings’ section, you will see a list of all programmes offered at your school, just like before. To set up the transcript template for a specific programme, click the arrow icon next to its name to view and configure its details.
💡Please note that this article uses the IBDP curriculum as an example, but the configuration steps are similar across all curricula.
Within the chosen programme, configure your transcript using these sections::
Evaluation settings – This section includes all the performance-related criteria such as ‘Overall score’, ‘Grade point’, ‘Credits’, and more.
GPA settings – This section allows you to configure the display of student’s GPA for each term/grading period and the overall GPA for the year.
Additional settings – Here, you can customise the labels for aggregates like ‘Total’ and ‘Average’ across all enabled evaluation criteria.
Earlier, this page only showed two default fields: ‘Overall grade’ and ‘Local grade’, with an option to add custom fields. These fields are now part of the broader evaluation settings section. Additionally, new section are added to include GPA-related fields and aggregate label customisation, giving you much more control over what gets shown in the transcript and how it appears.
💡Please note that anywhere you see a pencil icon - it indicates that you have the option to rename that field. Whatever name you choose to give will show in the transcript.
Let’s explore each one of these settings in detail.
Evaluation settings
The ‘Evaluation settings’ section lets you choose which evaluation criteria to include in the transcript. You can select from options like ‘Overall score’, ‘Overall grade’, ‘Local grade’, ‘Grade point’, ‘Credits’, and ‘Quality points’. You can also create custom columns if needed.
💡Please note that the evaluation criteria available here depend on the settings configured by you in the Academic Setup. For example, if the option to calculate credits is not enabled under Academic Setup > GPA & Credits > Credits, the ‘Credits’ option will not appear in your transcript template.
Keep in mind that you can enable up to four evaluation criteria at a time. If you wish to change the order in which they appear in the transcript, use the six-dot menu beside each one to drag and rearrange them as needed. All your selections are reflected in real time through the transcript preview on the right, so you can see exactly how they will appear when downloaded.
💡Please note that except for ‘Grade point’, all criteria (including custom ones) allow you to display aggregates such as ‘Total’, ‘Average’, ‘Year total’, and ‘Year average’. You can enable any combination of these based on your school’s needs.
GPA settings
In the ‘GPA settings’ section, you can choose to include ‘GPA’ (grading period-wise) and ‘Overall GPA’ (for the entire year) in the transcript by enabling the respective checkboxes.
💡Please note that the way GPA is calculated depends on the configuration done in the ‘Academic setup > GPA & Credits > GPA’. For example, if you’ve selected the ‘Weighted (with Credits)’ method, GPA will continue to factor in credits - even if the ‘Credits’ field is not displayed in the transcript. This ensures consistency with the grading settings you’ve set up.
Additional settings
The ‘Additional settings’ section allows you to customise the labels for aggregates like ‘Total’ and ‘Average’ in the transcript.
Simply click on the pencil icon next to the label you’d like to change and enter your preferred text.
The changes you make to these labels will apply across all relevant evaluation criteria and will instantly reflect in the transcript preview on the right.
Once you’re done configuring your template, click on the ‘Save and exit’ button in the top-right corner to save your changes and exit the template editor.
Generating transcripts
Once you have configured your report template, select the year group for which you would like to generate transcripts and click on the 'Start configuration' button corresponding to that year group.
Importing data for transcripts
Just like before, on the landing page, you’ll see all academic years linked to the selected year group. Here, you can take the following actions:
Select the academic years and terms that you want to include in the transcript
For each academic year, choose how you’d like to import data for every term. You can do so in either of the two ways:
Using progress reports generated on Toddle
Adding data using a CSV file
Both options continue to work the same way as before, with one key change - there are now new fields in the CSV template to support the introduction of ‘Grade points’ and ‘Credits’.
Let’s click on the ‘Import CSV’ option to explore this further.
💡Please note that when importing data from progress reports, the system pulls data directly from the Toddle platform, and not based on how it is displayed in the report. This means that it doesn’t matter whether certain fields, such as ‘Grade point’, ‘Credits’, or ‘Quality points’, were included in the report set. As long as the data exists in the system, it will be imported into the transcript if those fields are enabled in your transcript template. For example, you might have chosen not to display ‘Credits’ in the progress report, but if you have enabled ‘Credits’ in the transcript configuration, the corresponding data will still appear during the import process. This ensures consistency and saves you from re-entering data manually.
Upon selecting the 'Import CSV' button, a modal will appear, providing you with the option to download a template.
This template will include pre-populated columns with student and subject information. You can enter scores, grades, grade points, credits, and other data for each student in the relevant columns, and modify any information as needed. Based on your transcript template configuration, now you may also see additional fields such as ‘Grade point’, ‘Credits’, and ‘Quality points’ - if they have been enabled. Once completed, save the file in CSV format and upload it back to Toddle.
💡Please note that the fields visible in the CSV file may vary depending on the template configuration you’ve selected. If you choose to leave ‘Grade point’, ‘Credits’, and ‘Quality points’ blank, they will be auto-calculated based on the settings defined in the Academic Setup. However, any values you enter for these fields in the CSV will override the auto-calculated values from the Academic Setup.
Once you’ve filled out the CSV file, upload it under the ‘Updated filled template’ section in the modal and click ‘Proceed’. You’ll then see an analysis of the uploaded file, highlighting any missing fields or issues. Review the information, and complete the upload process from here.
As a final step, click on ‘Save’ to confirm and complete the import.
Reviewing transcripts
After importing transcript data, you can easily review each student’s transcript.
The review process works just as it did before, with one new enhancement — you can now see when a value has been manually overridden. Let’s take a look at how these changes are flagged.
To begin reviewing, navigate to the selected year group and find the student whose transcript you wish to review.
You will be directed to the updated transcript page for the selected student. Here you will see the fields as configured by you in the transcript template.
If you edit a value that is automatically calculated, the field will be highlighted in yellow to indicate that it has been manually overridden. You’ll also see a comparison between any values imported via CSV and the ones calculated by Toddle based on the configuration set in the Academic Setup.
💡Please note that data imported via CSV overrides the platform’s auto-calculated values. If the imported value differs from the calculated one, it will appear in yellow.
Click on a value to view the original calculated value. If you wish to revert your changes and restore the original, simply click the reset icon in the pop-up, as shown in the screenshot below.
Finally, click the ‘Download transcript’ option to download a PDF version of the transcript.
That's all for now. We will continue to innovate and improve to make your Toddle experience better each day!