Skip to content
Adapt User's Guide version 4.5


The Assessment provides a score for all the question components contained within a single article and that communicates the score to the LMS if so configured.

It does not display results. Results are presented with the Assessment Results component.

The Assessment extension applies to the entire article. Since randomization may reorder blocks within the article, it is highly recommended to include only question components within the assessment article.

The Results component must be placed in a separate article, not within the assessment article.

Blocks inside an assessment article must contain a question. Any blocks containing only presentation components will not be rendered when the article is restored.

While fairly obvious, only question components can be used in an Assessment. In Addition, some question components do not play well with Assessments, so it’s best to stick with primarily Multiple Choice questions. Question Cards do not work in assessments and any drag & drop-based components are not a good choice for assessments.

Assessment component is configured on three levels of the content structure: Project Settings, Article Settings, and Block settings.

Unlike other components that are self-configuring, the Assessment requires significant configuration to work correctly. The settings in both Project Settings and Article Settings are required and must be set correctly for the assessment to function. Pay special attention to the fields marked Important below.

In most situations, it’s better to create an assessment in Totara rather than in Adapt. The reporting is better, and the users are more familiar with them. However, the in-SCORM assessment can be the right tool for the job, with better options and more flexibility.

The options in project settings apply to all assessments in the course. They are:

Sends the score to the LMS if the Spoor extension is installed and configured to support this.

Some additional configuration may be required in Spoor depending on the LMS. The values in Submit score, Record responses, Tracking success status, and Assessment failure status may need to be tested and tweaked to ensure that it meets the LMS vendors understanding of the SCORM 1.2 spec (which can vary greatly).

Determines if the Pass mark is a percentage number or a number based on the sum of the question weight for all questions. If you are sending the score to the LMS, this must be checked.

A minimum score that the user must have in order to pass the assessment. Depending on the setting of Percentage based, this may be an integer based on the minimum number of questions answered correctly (balanced by the weight of each question) or an integer for the percent.

To create an assessment, you’ll need to create a page with two articles, one to contain all of the questions in the assessment, and another to contain a Text component (letting the user know they’ve completed the assessment and how the assessment is scored) and the Assessment Results component.

Other articles can be placed before the Assessment Article and in between the assessment article and the article containing the Assessment Results. There should not be an Article after assessment Results.

Determines if the article is an assessment. Must be checked on the Article that contains the questions in the assessment. Unchecked by default.

Important: The internal name of the assessment used to bind the Assessment Results component to the assessment. This should be one word (or spaces removed if multiple words) and while it can use upper case letters, the field is case-sensitive — meaning when you use it in other locations, the case must match perfectly.

Note: Some text found in the Adapt Authoring tool indicates that this field can be left blank if there’s only one assessment. This has not been the case in our testing.

Controls the number of attempts the user is allowed to have on this assessment before it is locked.

Determines whether the value of ‘Pass mark’ should be treated as a percentage or as the raw score. If there is only one assessment in the course, this value should match the values in Project Settings.

The minimum score required by the learner to pass the assessment.

Determines if the score from this assessment should be sent to the LMS. The score sent is a percentage according to ‘Assessment Weight’.

The weight of the assessment if multiple assessments are used to create a final course score. Example: 1 equals 100%, 0.5 is 50%, etc.

If checked, the assessment will override settings in questions that would display the marking that shows correct/incorrect answers. This should typically be checked.

Controls whether the assessment should be reset automatically (up to the number of available attempts) when a user revisits the page. This should typically be checked.

Controls whether the assessment may be reset after it has been passed (whilst there are attempts remaining).

If randomization is enabled, a specified number of blocks will be displayed to the user in a random order.

The number of blocks to display. If set to a number less than the number of blocks in the article, this setting will create a question pool. Set to -1 or 0 to display all blocks.

Setting this to more than the number of blocks in the article will cause an error.

Important – Advanced setting: This is an advanced setting requiring special configuration. Use caution enabling this setting.

Enables associating blocks of question components with a ‘bank’, allowing questions to be grouped. If Question Banks are enabled, you must configure question banks on each Block and correctly configure the Split property.

Important – Advanced setting: This is an advanced setting requiring special configuration. Use caution enabling this setting.

This is a comma-separated list of numbers corresponding to the number of questions to be drawn from each question bank. The position of the number in the list corresponds to the ‘Bank ID’ assigned, e.g. 3,2 would display three questions from Bank 1 and two from Bank 2.

This setting requires that you correctly configure question banks on each Block.

If checked, the questions within each bank will be randomized.

Determines whether the question will register as completed when reset. When assigned a value of ‘soft’, the learner may continue to interact with it, but the complete attribute remains set. When assigned ‘hard’, complete is set to false, and the learner will be forced to complete it again if it is reset.

Allows the user to view feedback on their answer. This setting requires that question feedback is set on the question component.

Displays ticks and crosses on question completion after the assessment is complete.

Allows the user to view the ‘model answer’ should they answer the question incorrectly after the assessment is complete.

There is only one field for the Assessment in the Block settings: Bank ID. The Bank ID is used to create question banks and must be set for Question Banks settings on the Article to function correctly.

The Bank IDs are integers, starting with 1 and proceeding in order (you cannot skip from Bank ID 1 to Bank ID 3 or from 3 to 5, etc.). If you are not using question banks, leave this set to 1.