In this section · 3 articles

Question Bank fields and permissions

Every field on the exam board, topic, sub topic, exam, question, paper queue and mock test forms, the columns of each list, the notifications, and the permissions behind each screen and action.

Applies to
Question Bank 3.5 and later
Who can do this
Platform owner, Administrator
Where
Question Bank
On this page

Exam board, topic and sub topic

Question Bank › Exam Boards, Topics and Sub Topics. See Set up exam boards, topics and exams.

ScreenFieldRules and notes
Exam boardNameRequired. Up to 500 characters. Unique.
SlugMade from the name if left empty. Can't be changed after creation.
TopicNameRequired. Up to 500 characters. Unique within its board.
Exam BoardRequired.
SlugMade from the name if left empty. Unique within the board. Can't be changed after creation.
Sub topicNameRequired. Up to 500 characters. Unique within its topic.
TopicRequired.
SlugMade from the name if left empty. Can't be changed after creation.

Each list also counts what's filed under a record (Exams, Topics, Sub Topics or Questions), and shows Created At and Updated At with who did it. Any custom fields you add appear on these forms too.

Exam

Question Bank › Exams.

FieldRules and notes
NameRequired. Per language.
SlugUp to 255 characters. Made from the name if left empty. Can't be changed after creation: imported papers find their exam by it.
Available languagesThe languages the paper is published in. Empty means every language your Laramin runs, shown as All languages.
Exam BoardOptional. One of your boards.
Category, Session, Standard, Board, CodeOptional text, up to 255 characters each. Board is free text, separate from Exam Board.
Total QuestionsOptional. The number of questions the paper has.
YearOptional. Four digits.
FileOptional. A document, such as a PDF of the paper.
StatusActive or Inactive.
The Create Exams drawer with Name, Slug, Available languages, Exam Board, Category, Session, Standard, Board, Code, Total Questions, Year, a File upload area and Status.

The list also shows Total Questions as questions added against the paper's total (42 / 100), Paper Queue as imported against extracted questions and the number of queued pages, and Cost (USD) as the AI cost of reading its pages. Despite its name, Cost (USD) shows the amount in rupees, converted at a fixed rate, for example ₹ 0.41.

The Exams list with six exams, showing Total Questions as added against the total, such as 3 / 70, Paper Queue as imported and queued counts, and the Cost column in rupees.

Question

Question Bank › Questions. New Questions and each row's Update Question open the question builder. See Write a question in the question builder.

Builder fieldRules and notes
TypeRequired. One of the seven question types.
StatusActive or Inactive. Only Active questions go into mock tests, and they need at least two answer choices with one marked correct.
ExamOptional. The exam the question belongs to. Its Available languages decide the language tabs.
NumberOptional. The question's number in the paper.
Topic, Sub TopicOptional. The sub topic must belong to the topic.
CategoryOptional text, up to 255 characters. Mock test rules can match on it.
Math questionTurns the text boxes into math editors.
HTML questionAdds an HTML content box for formatted content, such as a table.
Question, Sub textPer language.
Answer rowsPer type: see the builder article. Each row has a Label and Text, per language.

The row's Edit form also has Image, Difficulty (Easy, Medium, Hard) and Keywords, which the builder doesn't show.

The question builder's Question details card for a new question, with Type, Status, Exam, Number, Topic, Sub Topic and Category, plus the Math question and HTML question switches.

The list can show, and filter by, every column: ID, Question, Type, Exam, Number, Category, Is Math?, Is HTML?, Status, Difficulty, Topic, Sub Topic, Keywords and Updated. More are in the columns menu: Frequency, Probability, Analysed, Formatted, Rendered as HTML, Paper Queue, Has Image, Has Clarifications, Created By, Updated By, Created and Clarified. Dates filter by Today, Last 7 days, Last 30 days, This month, This year or Older than a year.

The Questions list in Question Bank with the Columns menu open, showing 14 of 26 columns and the extra columns such as Frequency, Probability, Paper Queue, Has Image and Created By unticked.

Bulk actions: Add to test, Export to HTML, OMR answer sheet and Set Topic.

Paper queue

Question Bank › Paper Queue. See Import questions from an exam paper.

FieldRules and notes
TitleUp to 255 characters.
ExamRequired. Imported questions are attached to it.
Source TypeImage Source, HTML Source or JSON Source.
ImageFor an image source: a picture of the page.
HTML SourceFor an HTML source: the page's markup.
JSON SourceFor a JSON source: questions as a JSON array. Checked on save.
OrderThe page's place in the paper.
StatusStarts at Created.
The Create Paper Queue drawer with Title, Exam, Source Type set to Image Source, an Image upload area, Order, and Status set to Created.

The list also shows Progress (imported against extracted questions), Cost (USD) (in rupees, as for exams), the question Type and Is Math? found in the extract, and Created At.

Paper statuses

StatusMeaning
CreatedAdded, waiting to be read.
ProcessingBeing read by AI.
ExtractedRead; questions are ready to check.
Re-QueuedSent back to be read again.
ImportedEvery extracted question is in the bank.
Partial InsertedSome extracted questions are in the bank.
Skipped (no AI)No AI provider was available, so nothing was read or charged.
FailedReading failed after three tries.
Pending, Partial Extract, Updated, Review Pending, Completed, CancelledSet by people during review, to track where a page stands.

Mock test

Question Bank › Mock Tests. See Create a mock test.

TabFieldRules and notes
Test DetailsTitleRequired. Up to 255 characters.
SlugRequired. Up to 255 characters. Unique. Can't be changed after creation.
StatusActive or Inactive. Only Active tests count as open to learners, although in this version learners can't see or take any test.
No. of RevisionsThe most attempts a learner can make, counting the first. 0 or empty means unlimited.
Revision Interval (in Days)Days a learner must wait after starting one attempt before the next. 0 means no wait.
Expose AnswerIncludes the correct answers in a learner's result. Learners can't open their results in this version, so it has no visible effect for them.
QuestionsExamsOnly questions from these exams. Empty means any exam.
QuestionsThe question types to include. Empty means every type.
CategoryOnly questions whose Category contains this text.
Math FilterAll Questions, Math Questions or Non-Math Questions.
No. of QuestionsHow many matching questions to take: a number, -1 for all, or a range such as 0-50. Empty or 0 takes none.
The Create Mock Tests drawer on the Test Details tab, with empty Title, Slug, Status, No. of Revisions and Revision Interval (in Days) fields and the Expose Answer switch turned off.
The Create Mock Tests drawer on the Questions tab, with empty Exams, Questions, Category, Math Filter and No. of Questions fields.

The Questions tab is hidden once anyone has sat the test. The list shows Title, Slug, Status, Questions (how many), Revise Interval (attempts and days), Created At and Updated At, and each row has Print.

Test submission

Question Bank › Test Submissions is read-only. Columns: ID, Mock Test, Status (Completed, In Progress, Cancelled), Revision (the attempt number, such as Rev 2), Started (the learner and when), Test Result (attempted, correct, wrong, accuracy, time and time per question), Created At and Updated At. Each row has Analytics and Delete. See Review test submissions and analytics.

Notifications

NotificationSentDefault channels
Mock Test AssignedTo a learner when they start a new attempt.In-app and email
Mock Test CompletedTo a learner when they finish an attempt.In-app and email
Question Added to ExamTo the person who creates a question, in the builder or the Edit form.In-app

In 3.5.2 no attempt can be started or finished, so the two mock test notifications are never sent. Question Added to Exam is described as sent "when new questions are loaded into an assigned exam", but it goes to whoever created the question, and reads "new questions have been added to your assigned exam". Turn them on or off in Notification Manager. See Turn a notification on or off.

Permissions

Give these through a role. See Give someone a role. Learners need none of them to open My Tests.

GroupPermissionsNotes
Exam Boards, Topics, Sub Topicsfeature.qb.<exam_board, topic or sub_topic>. list, view, create, edit, delete, restore, removeShared reference data: no Own versions. delete moves to the trash; remove deletes forever.
Examsfeature.qb.exam.*: the seven above, plus list_own, view_own, edit_own, delete_own, restore_own, remove_ownOwn versions limit a person to exams they created.
Questionsfeature.qb.question.*: the seven plus their Own versions, and:
add_to_test (Add Questions to Mock Test)The Add to test bulk action.
bulk_export (Bulk Export Questions)Export to HTML, OMR answer sheet, and a mock test's Print.
bulk_soft_delete, bulk_restore, bulk_deleteKept for compatibility. The list's bulk delete and restore use the per-question permissions.
Paper Queuesfeature.qb.paper_queue.*: the seven plus their Own versions, and:
review (View Paper Queue Review)Shows the Status action on the review screen. Saving a status also needs edit (or edit_own for your own pages).
requeue (View Paper Queue Requeue)ReQueue the Paper on the review screen. edit_own also allows it on your own pages.
extract (View Paper Queue Extraction)Open a page's source document. view_own also allows it on your own pages.
bulk_import (Bulk Import Paper Queues)The Import action.
bulk_soft_delete, bulk_restore, bulk_deleteBulk trash, restore and delete forever.
Mock Testsfeature.qb.mock_test.*: the seven plus their Own versions
Test Submissionsfeature.qb.test_submission.*: the seven plus their Own versionscreate and edit grant nothing: no screen creates or edits a submission.

New Question Bank permissions are never added to roles automatically, except for super admins. Grant them to each role that needs them.