# Create
## Assessment Content
On the **Basic or Content** tab, you are able to set:
1. **Title**\
Make sure you use a **meaningful title** that summarises what the students are meant to do.
2. **Description/case**\
Here’s the **description of the case** you want the students to discuss and respond to.
## Questions list
The questions section is where you can add the questions and set up their properties.
If you want to move the question order, you can drag and drop each question up and down to position the questions in your required order.
In the `Mark` field, you can add the number of points that will be given to the students when they answer the question correctly.
### Printout options
The Printout Options feature allows you to **generate a printable version of your assessment for offline use**. Ensures continuity of teaching and assessment in any environment, supports **hybrid and flexible delivery models** and gives you full control over both digital and paper-based formats.
Printout Assessments
This **provides flexibility in how assessments are delivered**, ensuring that teaching and evaluation can continue even when digital access is limited or disrupted.
**What you can do:**
* Generate a printable version of the exam
* Choose whether to include correct answers
* Create different versions for lecturers/tutors and students
**Common use cases:**
* **Instructor copy (with answers):**
Ideal for lecturers and tutors to use as a marking guide or reference during facilitation.
* **Student copy (without answers):**
Can be distributed as a paper-based assessment, allowing students to complete the exam offline.
* **Contingency planning:**
Provides a reliable backup in case of:
* Network issues
* Device limitations
* Classroom delivery constraints
### Adding questions
Questions in the Q\&A activity can be of multiple question types:
* `Multiple choice`,
* `Matching pairs`,
* `Short answer`,
* `Numerical`,
* `True/False`,
* `Essay`,
* `Ordering`,
* `Mark hedging`.
{% hint style="success" %}
For the sake of simplicity, in this example we will only explore Multiple Choice questions.
{% endhint %}
To add a question from scratch, select the question type to add press the **`+`** button to begin.
Questions might have various advanced settings from marks, feedback on various answer outcomes and etc.
When adding question, by default questions go into your own private Questions Bank collection.
{% hint style="info" %}
**Map question to learning outcomes**
You can tag learning outcomes to specific questions for better curriculum mapping
{% endhint %}
### Adding question from Question Bank
If your questions already exist in the Question Bank, you are able to import them directly into the Assessment activity.
When you select a question, then the question is displayed in full including the question version (Question Bank supports question versioning).
Once you decide on the question to be added, by clicking on the “**Import**” button, the question is then added to the Readiness Assurance Test.
Additionally, by clicking on “**Stats**”, you can view detailed analytics for the selected question.
{% hint style="success" %}
**Powerful Analytics**
The analytics display the question in its ***full life-cycle*** -in which other lessons it has been used, full item analysis including (difficulty, discrimination index and point biserial coefficient). This is particularly important for the lecturer as it gives a clear picture on the reliability of the questions to include in their TBL lessons.
{% endhint %}
#### **Related**
{% embed url="" %}
### Import question from Microsoft Word
You can import questions into TBL learning designs using a Microsoft Word template. Using the Microsoft Word template, you can create sophisticated questions with **elaborate formatting, including images, tables and text.**
Additionally to adding format, questions imported from Microsoft Word can also contain specific metadata such **Learning Outcomes** and **Feedback**.
{% hint style="success" %}
**Learning Outcome Support**
When adding questions, you can specify which learning outcomes are assessing. This makes curriculum compliance very easy.
{% endhint %}
Currently (as of LAMS v4), the question types allowed are **Multiple Choice Questions** (MCQ), **Very Sort Answers** (VSA), **Mark Hedging** and **Essay questions**. In the near future, other questions types might be included.
The Microsoft Word Question template format can be downloaded [here](https://raw.githubusercontent.com/lamsfoundation/lams/v4.0/lams_www/web/public/MSWord-question-import.docx). The template includes all instructions and examples on how to prepare question to be imported.
{% hint style="info" %}
**IMS QTI imports**\
\
You can also import question using [IMS QTI format](https://www.imsglobal.org/question/qtiv1p2/imsqti_asi_bindv1p2.html).
{% endhint %}
## Advanced Settings
The Advanced settings allow you to control how the assessment behaves, how students interact with it, and how feedback is delivered. You can use these options to design anything from simple quizzes to highly interactive, team-based learning experiences.
#### Question Behaviour
* **Shuffle questions**
Randomises the order of questions for each student. Helps reduce answer sharing.
* **Shuffle answers**
Randomises answer options within each question. Prevents patterns that students could memorise.
* **Enable question numbering**
Displays question numbers to students. Helps navigation and referencing during discussions.
#### Choose Restrictions
* **Attempts allowed**
You control how many times a student can attempt the assessment. Use this to limit retries or allow practice through multiple attempts.
* **Assessment passing mark**
You set the minimum score required to pass. This is useful when you want to enforce mastery before progression. Useful for progression or gating.
#### Feedback & Results
* **Display all questions and answers once finished**
Shows full review after completion. Supports reflection and self-correction.
* **Allow students to see question feedback after each question**
You show feedback immediately after each question is answered. This reinforces learning in real time and helps students correct misunderstandings early.
* **Disclose student’s answers in monitor**
You can share student or team answers through the monitoring interface. This enables whole-class discussion and comparison of responses.
* **Allow students to rate peers’ answers**
You allow students to evaluate answers from other students or teams. This encourages critical thinking and peer learning.
* **Indicate choice(s) that have been answered correctly**
You show which selected answers are correct after submission. This reinforces correct understanding.
* **Indicate choice(s) that have been answered incorrectly**
You show which selected answers are incorrect. This helps students identify and learn from mistakes.
* **Allow learners to see history of responses at the end of each attempt**
You allow students to review their previous responses after completing an attempt. This supports reflection and self-assessment.
* **Allow students to see question maximum mark**
You display the maximum mark for each question. This helps students understand the weighting and importance of each question.
* **Allow learners to see marks at the end of each attempt**
You show the total score immediately after submission. This provides instant feedback on performance.
#### Student Interaction
* **Enable answer justification**
You require students to explain their answers in writing. This promotes deeper thinking and reasoning.
* **Enable burning questions**
You allow students to submit questions, challenges, or requests for clarification. You can review and address these during or after the assessment.
* **Enable focus tracking**
You track whether students leave and return to the assessment. This provides insight into engagement and behaviour during the activity.
* **Enable discussion sentiment voting**
Lets students indicate agreement or readiness to move on. Helps you gauge class understanding in real time.
* **Enable confidence level**
For question, students indicate how confident they are in their answers. This helps identify uncertainty and supports richer team discussions.
#### Notifications
* Notify instructor when student completes attempt
Sends you a notification each time a student submits.
Helps you monitor progress in real time.
### Leader selection
The Leader Selection settings allow you to control how answers are submitted when students are working in teams. This is particularly useful in [Team-Based Learning (TBL)](https://docs.lamsfoundation.org/tbl/) or other collaborative assessment scenarios.
You enable team-based submission using a previously assigned leader.
When you turn this option on:
* Only the team leader selected in the earlier Select Leader activity can submit answers.
* All other team members can still view the questions and participate in discussion, but they cannot submit responses.
* Each team submits a single, agreed answer through their leader.
{% hint style="info" %}
**Availability Requirement**
This option is only available if your learning design includes a [Leader Selection](/lams/tools/leader-selection.md) activity before the Assessment.
* You must ensure the Leader Selection activity has been completed before students reach the Assessment.
{% endhint %}
The [Leader selection](#leader-selection) tool is another LAMS activity that allows students to select a student leader or representative for their group. If this activity is present in your design, then you can specify that the Assessment exam should only be answered by the selected leader. See the [Leader selection](#leader-selection) activity for further details and examples.
### Time Limits
The Time Limits settings allow you to control how much time students have to complete the assessment. You can choose different timing strategies depending on whether your session is synchronous, asynchronous, or team-based.
**None**
You do not apply any time restriction.
* Students can take as long as they need to complete the assessment.
* Suitable for low-pressure activities, practice tasks, or reflective learning.
**Activity**
You set a single shared countdown timer for the entire class.
* The timer starts when the first student begins the assessment.
* All students must complete the assessment before the timer runs out.
* Late starters have less time remaining.
When to use:
* Live, synchronous sessions (e.g. classroom or workshop).
* Situations where you want all students progressing at the same pace.
**Individual students**
You assign a fixed duration for each student.
* The timer starts individually when each student begins the assessment.
* Every student receives the full allocated time, regardless of when they start.
When to use:
* Asynchronous learning.
* Online courses where students access the assessment at different times.
**Threshold**
You trigger a countdown based on class progress.
* The timer starts when a defined percentage of students have completed the assessment (e.g. 50%).
* Once triggered, remaining students must finish within the remaining time.
* You can configure how much time is given after the threshold is reached.
When to use:
* Synchronous sessions where you want to balance pacing across the group.
* Situations where faster students should not wait too long, while still giving others time to finish.
### Question Distribution
The Question Distribution settings allow you to control how questions are presented to students during the assessment. You can use these options to manage cognitive load, control pacing, and guide how students progress through the activity.
**All in one page**
You display all questions on a single page.
* Students can view and answer all questions at once.
* They can move freely between questions and review their answers before submitting.
When to use:
* Short assessments.
* Open-book or reflective activities.
* Situations where students benefit from seeing the full context.
**Questions per page**
You split the assessment questions into multiple pages, showing a set number of questions per page.
* Students progress through the assessment page by page.
* Helps break the assessment into manageable chunks.
When to use:
* Longer assessments.
* When you want to reduce cognitive overload.
* To encourage focus on smaller groups of questions.
**Sections**
You organise questions into sections or categories.
* Each section can represent a topic, theme, or difficulty level.
* Students progress through structured parts of the assessment.
When to use:
* Assessments covering multiple topics.
* When you want to clearly structure the flow of the assessment.
* To mirror exam-style formats.
**Sequential questions**
You require students to answer one question at a time in a fixed order.
* Students cannot skip ahead.
* Each question must be answered before moving to the next.
* Sequential question can also have an option to hide already answered questions
When to use:
* High-stakes assessments.
* Situations where you want to prevent backtracking or answer revision.
* Activities focused on step-by-step reasoning.
* Hide previously asked questions
### Learning Outcomes
{% hint style="success" %}
**Mapping learning outcomes to activities is very useful for curriculum mapping.**
{% endhint %}
Add learning outcomes to the activity
As with all activities in LAMS, you can map your learning outcomes to this activity. If you want to add a learning outcome, just search for the particular outcome or type a new one it will be added to your list of learning outcomes for the future.
You can search Learning Outcomes by code or name.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.lamsfoundation.org/lams/tools/assessment/create.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.