Question Bank
Categories & Tags
BeamEdUp provides multiple ways to organize your question bank: subjects, topics, difficulty levels, tags, and status. Effective categorization makes it easy to find, filter, and reuse questions across exams.
Question Metadata
Every question has a metadata object with these organizational fields:
| Field | Type | Description |
|---|---|---|
subject | string | Primary subject (e.g., Mathematics, Science, English). Must match a subject configured in your organization. |
topic | string | Specific topic within the subject (e.g., Algebra, Photosynthesis). |
subtopic | string | Further subdivision (e.g., Linear Equations, Light Reactions). |
keywords | string[] | Searchable keywords for full-text search. |
estimatedTime | number | Expected time to answer in seconds. Used for exam time estimation. |
bloomTaxonomy | string | Bloom's taxonomy level: Remember, Understand, Apply, Analyze, Evaluate, or Create. |
Difficulty Levels
Each question has a difficulty field with three levels:
- EASY — basic recall and recognition. Students who attended class should answer correctly.
- MEDIUM — requires understanding and application. The default difficulty level.
- HARD — demands analysis, synthesis, or evaluation. Typically only top students answer correctly.
Difficulty Balance
Tags
Tags are free-form labels you attach to questions for flexible categorization. Unlike subject/topic (which are hierarchical), tags are flat and can represent any grouping.
- Chapter tags — e.g., "chapter-5", "unit-3"
- Skill tags — e.g., "problem-solving", "critical-thinking"
- Exam tags — e.g., "midterm-2024", "final-practice"
- Curriculum tags — e.g., "CBSE-Grade-10", "AP-Biology"
Tag Input
Status Management
Questions have a status field that controls their availability:
- DRAFT — newly created or imported questions. Not available for use in exams. Edit freely.
- PUBLISHED — reviewed and approved. Available for selection when creating exams.
- ARCHIVED — retired questions no longer in active use. Hidden from the exam builder but preserved in history.
Filtering & Search
The questions list page supports these filters via the ListQuestionsParams interface:
search— full-text search across question texttype— filter by question type (MCQ, ESSAY, etc.)difficulty— filter by EASY, MEDIUM, or HARDsubject— filter by subjecttags— filter by one or more tagsstatus— filter by DRAFT, PUBLISHED, or ARCHIVEDbranchId— filter by branch (multi-branch organizations)
Combine Filters