<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en">
	<id>https://docs.moodle.org/39/en/api.php?action=feedcontributions&amp;feedformat=atom&amp;user=Kurien</id>
	<title>MoodleDocs - User contributions [en]</title>
	<link rel="self" type="application/atom+xml" href="https://docs.moodle.org/39/en/api.php?action=feedcontributions&amp;feedformat=atom&amp;user=Kurien"/>
	<link rel="alternate" type="text/html" href="https://docs.moodle.org/39/en/Special:Contributions/Kurien"/>
	<updated>2026-05-14T11:35:23Z</updated>
	<subtitle>User contributions</subtitle>
	<generator>MediaWiki 1.43.5</generator>
	<entry>
		<id>https://docs.moodle.org/39/en/index.php?title=Grade_items&amp;diff=96176</id>
		<title>Grade items</title>
		<link rel="alternate" type="text/html" href="https://docs.moodle.org/39/en/index.php?title=Grade_items&amp;diff=96176"/>
		<updated>2012-03-01T14:47:44Z</updated>

		<summary type="html">&lt;p&gt;Kurien: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;{{Managing grades}}&lt;br /&gt;
{{Improve}}&lt;br /&gt;
A grade item is a unit (typically an activity) where course participants are assessed through a grade or mark.&lt;br /&gt;
As such, a grade item is a container for grades and a set of settings applied to these grades. The settings affect the calculation and display of the grades in the gradebook reports and [[Grade_export|exports]].&lt;br /&gt;
&lt;br /&gt;
Grade items may refer to course activities (e.g. a quiz, an assignment etc.), [[Outcomes]] or  manual grades. &lt;br /&gt;
&lt;br /&gt;
== Grade items and gradebook ==&lt;br /&gt;
The three building blocks of the Gradebook are:&lt;br /&gt;
&lt;br /&gt;
#The grade item&lt;br /&gt;
#The [[Grade_categories|grade category]]&lt;br /&gt;
#The [[Grades|grade]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Grade items are represented by columns in the [[Grader_report | grader report]].&lt;br /&gt;
&lt;br /&gt;
Within a category, a [[Grades|grade]] summary is also a grade item itself.  Summary grade items for a category can show up in reports, and can be used in the calculation of the grade for the parent category.&lt;br /&gt;
&lt;br /&gt;
== Activity-based grade items ==&lt;br /&gt;
[[Image:Edit grade item.png|right|thumb|Editing a grade item]]&lt;br /&gt;
Modules that include a form of grading use the [[Development:Grades#API_for_communication_with_modules.2Fblocks|Gradebook API]] to generate a matching grade item, and to communicate their grades to the gradebook. The generated grade item can later be edited from within the gradebook interface (Course -&amp;gt; Grades -&amp;gt; Edit Categories and items -&amp;gt; Edit (hand icon) grade item), as seen in the screenshot to the right, but several of its settings will be &#039;frozen&#039;, only changeable from the activity module&#039;s interface. These are listed and explained below in the manual grade items section.&lt;br /&gt;
&lt;br /&gt;
Here is a list of the settings that can be edited for an activity-based grade item:&lt;br /&gt;
&lt;br /&gt;
*&#039;&#039;&#039;Item info&#039;&#039;&#039;: General information about the grade item. Optional.&lt;br /&gt;
*&#039;&#039;&#039;Grade to pass&#039;&#039;&#039;: Specify the minimum grade a student must achieve to be considered to have passed this item. This must be in real grades, not a percentage. Once this is done, grades will be highlighted in red for fail and green for pass in the gradebook. It doesn&#039;t work for scales, as it is yet to be fully implemented in Moodle 1.9. It is planned for use in [[Development:Course completion|course completion]] in Moodle 2.0.&lt;br /&gt;
*&#039;&#039;&#039;Grade display type&#039;&#039;&#039;: See the [[Grade_item_settings#Grade_display_type | Grade display type doc]]&lt;br /&gt;
*&#039;&#039;&#039;Overall decimal points&#039;&#039;&#039;: This specifies the number of decimal points to display for each grade. It has no effect on grade calculations, which are made with an accuracy of 5 decimal places. &lt;br /&gt;
*&#039;&#039;&#039;Multiplicator&#039;&#039;&#039;: Factor by which all grades for this grade item will be multiplied, with a maximum value of the maximum grade. For example, if the multiplicator is 2 and the maximum grade is 100, then all grades less than 50 are doubled, and all grades 50 and above are changed to 100. &lt;br /&gt;
*&#039;&#039;&#039;Offset&#039;&#039;&#039;: Number that will be added to every grade for this grade item, after the Multiplicator is applied. (Can be a negative number.)&lt;br /&gt;
*&#039;&#039;&#039;Hidden&#039;&#039;&#039;: Whether this grade item should be hidden from students.&lt;br /&gt;
*&#039;&#039;&#039;Hidden until&#039;&#039;&#039;: An optional date after which the grade item will no longer be hidden (i.e. a grades release date)&lt;br /&gt;
*&#039;&#039;&#039;Locked&#039;&#039;&#039;: Whether or not to lock this grade item. A locked grade item doesn&#039;t accept changes to its settings or grades from its related module.&lt;br /&gt;
*&#039;&#039;&#039;Locked after&#039;&#039;&#039;: A date after which the locking will be effective, usually after the grades release date.&lt;br /&gt;
&lt;br /&gt;
== Grade outcome items ==&lt;br /&gt;
[[Image:grade_outcome_item.png|right|thumb|Editing a grade outcome item]]&lt;br /&gt;
These can either be generated by the creation of a new activity module (by selecting [[Outcomes]] in the module creation form), or manually created like manual grade items. A grade outcome item uses a course outcome as its grading type, so such an outcome must be made available at the course level before a grade outcome item can be manually created.&lt;br /&gt;
&lt;br /&gt;
Grade outcome items can optionally be linked with an activity module. This is done automatically when a grade outcome item is generated by the creation of an activity module in which outcomes were selected. In this scenario, a grade category is also created and named after the activity module, and the grade item and grade outcome items are created as children of that category.&lt;br /&gt;
&lt;br /&gt;
The settings of the grade outcome item edit form are identical to those of manual grade items, with the addition of two settings:&lt;br /&gt;
&lt;br /&gt;
*&#039;&#039;&#039;Outcome&#039;&#039;&#039;: The course outcome represented by this item&lt;br /&gt;
*&#039;&#039;&#039;Linked activity&#039;&#039;&#039;: The optional activity module to which this item will be linked&lt;br /&gt;
&lt;br /&gt;
== Manual grade items ==&lt;br /&gt;
[[Image:manual_item.png|right|thumb|Editing a manual grade item]]&lt;br /&gt;
These grade items are created manually through the &amp;quot;Edit Categories and Items&amp;quot; page. The &amp;quot;Add grade item&amp;quot; button is clicked, and the form appears. Several options are available here which are normally automatically filled out by the activity module creating an activity-based grade item:&lt;br /&gt;
&lt;br /&gt;
*&#039;&#039;&#039;Item name&#039;&#039;&#039;: The display name of your grade item&lt;br /&gt;
*&#039;&#039;&#039;ID Number&#039;&#039;&#039;: An arbitrary string of characters used to refer to this grade item in Formulas. If set, it must be unique.&lt;br /&gt;
*&#039;&#039;&#039;Grade type&#039;&#039;&#039;: The type of grade: None (no grading possible), Value (a numerical value), Scale (an item in a list) or Text (arbitrary text). &lt;br /&gt;
*&#039;&#039;&#039;Scale&#039;&#039;&#039;: Which scale to use for grading: available only when the Scale grade type is selected. &lt;br /&gt;
*&#039;&#039;&#039;Maximum grade&#039;&#039;&#039;: The maximum grade that can be given (for scales: the number of items in the scale - 1)&lt;br /&gt;
*&#039;&#039;&#039;Minimum grade&#039;&#039;&#039;: The minimum grade that can be given (for scales: 0)&lt;br /&gt;
&lt;br /&gt;
Conversely, two of the settings found in the form for activity-based grade items are absent from this form:&lt;br /&gt;
*Multiplicator&lt;br /&gt;
*Offset&lt;br /&gt;
&lt;br /&gt;
==See also==&lt;br /&gt;
*[[Grade item settings]] - for administrators&lt;br /&gt;
&lt;br /&gt;
[[ca:grade/edit/tree/item]]&lt;br /&gt;
[[cs:Položky hodnocení]]&lt;br /&gt;
[[fr:Eléments d&#039;évaluation]]&lt;br /&gt;
[[ja:評定項目]]&lt;/div&gt;</summary>
		<author><name>Kurien</name></author>
	</entry>
</feed>