Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/geeky-hamster/Quizmaster/llms.txt

Use this file to discover all available pages before exploring further.

Quizmaster organizes content in a strict four-level hierarchy: Subjects contain Chapters, Chapters contain Quizzes, and Quizzes contain Questions. You must create each level before the next can be added — for example, you cannot create a chapter without an existing subject. This page walks through creating each content type in order, and explains how to edit or delete existing content.

​
Content hierarchy

Subject
└── Chapter
    └── Quiz
        └── Question

​
Creating content

Follow these steps in order when setting up new content from scratch.
1

Create a subject

Navigate to Subjects at /admin/subjects and click Add subject.Fill in the following fields:
FieldRequiredDescription
nameYesDisplay name for the subject (e.g., Mathematics)
descriptionNoOptional summary shown to users
Click Save to create the subject. It will appear in the subjects list and become available when creating chapters.
2

Create a chapter

Navigate to Chapters at /admin/chapters and click Add chapter.Fill in the following fields:
FieldRequiredDescription
subject_idYesThe subject this chapter belongs to
nameYesDisplay name for the chapter (e.g., Algebra)
descriptionNoOptional summary shown to users
Select the subject from the dropdown, enter a name, and click Save.
3

Create a quiz

Navigate to Quizzes at /admin/quizzes and click Add quiz.Fill in the following fields:
FieldRequiredDescription
ChapterYesThe chapter this quiz belongs to
NameYesDisplay name for the quiz
Time limitYesTime limit in minutes (enter a number, e.g., 30)
DescriptionNoOptional notes or remarks about the quiz
time_duration is stored and entered as a plain number representing minutes. For example, enter 30 for a 30-minute quiz.
Click Save to create the quiz.
4

Add questions to a quiz

From the Quizzes list at /admin/quizzes, click the Questions button next to the quiz you want to populate. This opens /admin/quizzes/:id/questions.Click Add question and fill in the following fields:
FieldRequiredDescription
question_statementYesThe question text shown to users
option1YesFirst answer option
option2YesSecond answer option
option3YesThird answer option
option4YesFourth answer option
correct_optionYesThe number of the correct option (1, 2, 3, or 4)
correct_option is 1-based. Enter 1 if the first option is correct, 2 for the second, and so on. Make sure the number you enter matches the option that contains the correct answer.
Click Save to add the question. Repeat for each question in the quiz.

​
Editing existing content

Each content list (subjects, chapters, quizzes, questions) shows an Edit button next to each item. Click it to open the edit form, make your changes, and click Save. All fields editable during creation are also editable here. Editing a subject or chapter does not affect the items nested under it. Changing a quiz’s chapter_id moves it to a different chapter.

​
Deleting content

Each item in a content list has a Delete button. Deleting a subject, chapter, or quiz also removes all content nested beneath it:
  • Deleting a subject removes all of its chapters, the quizzes in those chapters, and all questions in those quizzes.
  • Deleting a chapter removes all of its quizzes and their questions.
  • Deleting a quiz removes all of its questions and all score records for that quiz.
  • Deleting a question only removes that question; other questions and the quiz remain.
Review the content under an item before deleting it to avoid unintentional data loss.

Build docs developers (and LLMs) love

Get started for freeTalk to us