Question Bank

Creating MCQ Questions

Multiple Choice Questions (MCQs) are the most common question type. BeamEdUp supports both single-answer and multiple-answer MCQs using the same MCQ type with the multipleCorrect toggle.

Single vs Multiple Answer

Single answer (default) — exactly one option is marked isCorrect: true. Students select one option.
Multiple answers — enable the multipleCorrect toggle. Two or more options can be correct. Students must select all correct options for full marks.

Grading Logic

Single-answer MCQs are all-or-nothing. Multiple-answer MCQs award full points only when all correct options are selected and no incorrect options are chosen.

Step-by-Step Creation

Navigate to Questions

Go to Questions → Create Question from the sidebar.

Select MCQ type

Choose "MCQ" from the Question Type dropdown at the top of the form.

Write the question text

Enter your question in the text area. Use the rich text editor for formatting, images, or code blocks.

Add answer options

Click "Add Option" to add choices. Enter the text for each option and mark the correct one(s) using the isCorrect checkbox.

Set points and difficulty

Assign marks (points) and select the difficulty level (EASY, MEDIUM, or HARD).

Add metadata

Optionally set subject, topic, tags, and estimated time for better organization and filtering.

Save the question

Click Save. The question is created in DRAFT status. Publish it when ready for use in exams.

Common Fields

These fields apply to all question types, including MCQ:

Field	Required	Type	Description
Question Type	Required	select	Select "MCQ" from the dropdown.
Question Text	Required	textarea	The question prompt. Supports rich text formatting. Minimum 1 character.
Points	Required	number	Marks awarded for a correct answer. Must be 0 or greater. Default: 1.
Difficulty	Required	select	EASY, MEDIUM, or HARD. Default: MEDIUM.
Subject	Optional	select	Searchable dropdown of subjects configured in your organization.
Topic	Optional	select	Topic within the selected subject. Depends on subject selection.
Tags	Optional	text	Free-form tags for filtering (e.g., "algebra", "chapter-5"). Multi-select input.
Estimated Time	Optional	number	Expected time to answer in seconds. Default: 60.

MCQ-Specific Fields

Field	Required	Type	Description
Options	Required	list	Minimum 2 options required. Each option has text, an isCorrect flag, and optional feedback.
Multiple Correct	Optional	toggle	Enable to allow more than one correct answer. Off by default (single answer).
Shuffle Options	Optional	toggle	Randomize option order for each student during exams. Off by default.
Option Feedback	Optional	text	Per-option feedback shown after submission. Useful for explaining why an option is right or wrong.

Option Data Structure

Each MCQ option is stored with the following properties:

id — unique identifier (auto-generated)
text — the option text displayed to students
isCorrect — boolean flag for the correct answer(s)
feedback — optional explanation shown after submission

Writing Good MCQs

Keep options similar in length and complexity. Avoid "All of the above" or "None of the above" as they can be guessed through elimination. Use plausible distractors that reflect common misconceptions.

Question Types Overview

Creating True/False