Quiz System

Document Version: 1.0
Last Updated: January 2026
Audience: Youth Ministry Leaders, Church Administrators, Content Creators

---

Table of Contents

1. Overview
2. Quiz Structure
3. Creating Quizzes
4. Question Types
5. Difficulty Configuration
6. Scoring System
7. Quiz Modes
8. Assigning Quizzes
9. Analytics & Reporting
10. Troubleshooting
11. Best Practices

---

Overview

Purpose

The Quiz System provides interactive assessment and learning reinforcement tools that:

• Test scripture knowledge and comprehension
• Reinforce material from reading plans and sermons
• Drive engagement through gamified challenges
• Track student progress and identify knowledge gaps
• Award XP and achievements for performance

Key Components

Component	Description
Quiz	Collection of questions on a topic
Questions	Individual test items with answers
Difficulty	Easy, Medium, Hard, Expert levels
Scoring	Point system with bonuses
Modes	Practice, Timed, Group, Tournament
Analytics	Performance tracking and insights

---

Quiz Structure

Quiz Properties

Field	Type	Required	Description
title	String	Yes	Quiz name (3-100 chars)
description	String	Yes	What the quiz covers
category	String	Yes	Topic grouping
difficulty	Enum	Yes	Easy, Medium, Hard, Expert
timeLimit	Number	No	Seconds allowed (0 = unlimited)
passingScore	Number	No	Minimum % to pass (default: 70)
shuffleQuestions	Boolean	No	Randomize question order
shuffleAnswers	Boolean	No	Randomize answer order
showFeedback	Boolean	No	Show correct answers after
maxAttempts	Number	No	Retake limit (0 = unlimited)

Question Properties

Field	Type	Required	Description
questionText	String	Yes	The question prompt
questionType	Enum	Yes	Type of question
options	Array	Conditional	Answer choices (for MC)
correctAnswer	String/Array	Yes	Correct response(s)
explanation	String	No	Why this answer is correct
points	Number	No	Override default points
hint	String	No	Optional hint text
verseReference	String	No	Related scripture

---

Creating Quizzes

Step-by-Step Process

1. Navigate to Quiz Management

• Access Admin Panel → Quizzes
• Click “Create New Quiz”

1. Enter Basic Information

   Title: [Descriptive name]
   Description: [What students will be tested on]
   Category: [Select or create]
   Difficulty: [Easy/Medium/Hard/Expert]

3. Configure Settings

• Set time limit (if timed)
• Choose passing score threshold
• Enable/disable shuffling
• Set attempt limits

3. Add Questions

• Click “Add Question”
• Select question type
• Enter question text
• Add answer options
• Mark correct answer(s)
• Add explanation (recommended)

3. Review and Publish

• Preview entire quiz
• Test with sample answers
• Publish when ready

Quiz Categories

Category	Content Focus
Old Testament	Genesis through Malachi
New Testament	Matthew through Revelation
Gospels	Matthew, Mark, Luke, John
Epistles	Letters of Paul and others
Prophecy	Prophetic books and Revelation
Wisdom	Proverbs, Ecclesiastes, Psalms
History	Historical narratives
Doctrine	Theological concepts
Application	Practical faith living
Memory Verses	Scripture memorization

---

Question Types

Multiple Choice (Single Answer)

Configuration:

Type: multiple_choice
Options: 4 (recommended)
Correct: 1 answer

Example:

Question: "Who wrote the book of Romans?"
Options:
  A) Peter
  B) Paul ✓
  C) James
  D) John
Explanation: "Paul wrote Romans during his third missionary journey, around 57 AD."

Multiple Choice (Multiple Answers)

Configuration:

Type: multiple_response
Options: 4-6
Correct: 2+ answers
Scoring: Partial credit optional

Example:

Question: "Select all books written by John (choose all that apply)"
Options:
  A) Gospel of John ✓
  B) 1 John ✓
  C) 2 John ✓
  D) 3 John ✓
  E) Jude
  F) Revelation ✓

Fill in the Blank

Configuration:

Type: fill_blank
AcceptedAnswers: [array of valid responses]
CaseSensitive: false (recommended)

Example:

Question: "Complete the verse: 'For God so loved the _____ that he gave...'"
Accepted: ["world", "World", "the world"]
Reference: John 3:16

True/False

Configuration:

Type: true_false
Options: [True, False]
Correct: true or false

Example:

Question: "David was the first king of Israel."
Answer: False
Explanation: "Saul was the first king; David was the second."

Ordering/Sequence

Configuration:

Type: ordering
Items: [array of items to order]
CorrectOrder: [numbered sequence]

Example:

Question: "Arrange these events in order:"
Items:
  1. Creation
  2. The Flood
  3. Tower of Babel
  4. Call of Abraham

Matching

Configuration:

Type: matching
LeftColumn: [items]
RightColumn: [matches]
Pairs: [correct pairings]

Example:

Question: "Match the disciple to their description:"
Left: [Peter, Matthew, Luke, Paul]
Right: [Tax collector, Physician, Fisherman, Pharisee]

---

Difficulty Configuration

Level Definitions

Level	Criteria	Time/Question	Point Value
Easy	Common verses, obvious answers	30+ seconds	10 points
Medium	Less familiar, plausible distractors	20-30 seconds	15 points
Hard	Obscure references, similar options	15-20 seconds	25 points
Expert	Deep knowledge, time pressure	10-15 seconds	40 points

Difficulty Guidelines

Easy Questions Should:

• Use well-known verses (John 3:16, Psalm 23:1)
• Have clearly wrong distractors
• Focus on basic facts
• Require simple recall

Medium Questions Should:

• Include less famous passages
• Have plausible wrong answers
• Require some context knowledge
• Mix recall with comprehension

Hard Questions Should:

• Reference obscure passages
• Use similar verses as distractors
• Require deep understanding
• Test application and analysis

Expert Questions Should:

• Include original language insights
• Require cross-referencing
• Test theological nuances
• Challenge even scholars

---

Scoring System

Base Point Values

Difficulty	Correct	Wrong	Skip
Easy	10	0	0
Medium	15	0	0
Hard	25	0	0
Expert	40	0	0

Bonus Points

Bonus Type	Condition	Reward
Perfect Score	100% correct	+25% total
Speed Bonus	Under half time	+10 points
First Attempt	No retakes	+15% total
Streak Bonus	5+ correct row	+10 points
No Hints	Unused hints	+5 points

XP Conversion

Quiz XP = Base Score + Bonuses × Difficulty Multiplier

Difficulty Multipliers:
- Easy: 1.0x
- Medium: 1.25x
- Hard: 1.5x
- Expert: 2.0x

Achievement Triggers

Quiz completion can trigger these achievements:

• quiz_count: Total quizzes completed
• Perfect score badges
• Streak achievements
• Category mastery badges

---

Quiz Modes

Practice Mode

Settings:

Attempts: Unlimited
Time Limit: None
Hints: Available
Feedback: Immediate
XP Award: 50% of normal
Leaderboard: Not eligible

Use Case: Learning, review, low-stakes practice

Timed Challenge

Settings:

Attempts: 1-3 (configurable)
Time Limit: Enforced
Hints: Disabled
Feedback: After submission
XP Award: 100%
Leaderboard: Eligible

Use Case: Assessment, competition, engagement events

Group Battle

Settings:

Teams: 2-10
Simultaneous: Yes
Scoring: Cumulative team
Bonus: Team consensus (+20%)
Display: Live leaderboard

Use Case: Youth group nights, team building

Tournament Mode

Settings:

Format: Single/Double elimination
Rounds: Based on participants
Difficulty: Increases per round
Winner: Final round champion

Use Case: Special events, end-of-series celebration

---

Assigning Quizzes

Assignment Options

Method	Description
Open Access	Available to all, optional
Required	Must complete by deadline
Group Specific	Assigned to particular group
Individual	Assigned to specific student
Scheduled	Auto-releases at set time

Assignment Procedure

1. Select Quiz

• Navigate to quiz management
• Choose quiz to assign

1. Choose Recipients

• All members
• Specific groups
• Individual students

1. Set Parameters

• Due date (optional)
• Required vs optional
• Notification preferences

1. Confirm Assignment

• Review settings
• Send notifications
• Monitor completion

Deadline Management

Setting	Behavior
Soft Deadline	Warning after date, still accessible
Hard Deadline	Locked after date
No Deadline	Always available

---

Analytics & Reporting

Quiz-Level Metrics

Metric	Description	Action Threshold
Average Score	Mean percentage	< 60% = too hard
Completion Rate	Started vs finished	< 70% = investigate
Average Time	Mean completion time	Adjust time limits
Pass Rate	% meeting threshold	< 50% = review content

Question-Level Analysis

Metric	Insight
Correct Rate	Question difficulty
Distractor Selection	Effectiveness of wrong answers
Skip Rate	Question clarity issues
Time Spent	Difficulty vs confusion

Student-Level Tracking

Data Point	Use
Total Quizzes	Engagement level
Average Score	Comprehension level
Improvement Trend	Learning progress
Weak Categories	Focus areas
Strong Categories	Strengths

Reports Available

1. Quiz Summary Report

• Overall performance statistics
• Question-by-question breakdown
• Time analysis

1. Student Progress Report

• Individual performance over time
• Comparison to group average
• Recommended focus areas

1. Group Comparison Report

• Team/group rankings
• Engagement comparisons
• Category strengths by group

---

Troubleshooting

Common Issues

Issue	Cause	Solution
Quiz won’t submit	Connectivity	Retry, check internet
Score not recording	Session timeout	Re-authenticate, retake
Wrong answer marked correct	Data error	Review question config
Time ran out unexpectedly	Device clock	Sync system time
Can’t see assigned quiz	Permission	Check group membership

Technical Diagnostics

1. Verify Quiz Configuration

• All questions have correct answers set
• Point values assigned
• Time limits reasonable

1. Check Permissions

• Student is in assigned group
• Quiz is published (not draft)
• Assignment is active

1. Review Attempt Data

• Check attempt history
• Verify submission recorded
• Review answer log

---

Best Practices

Question Writing

Do:
✅ Write clear, unambiguous questions
✅ Create plausible wrong answers
✅ Include helpful explanations
✅ Reference specific scripture
✅ Test one concept per question

Don’t:
❌ Use trick questions
❌ Include “all of the above” frequently
❌ Write overly long questions
❌ Use absolute words (always, never)
❌ Make questions about obscure trivia

Quiz Design

Best Practice	Reason
10-15 questions ideal	Maintains engagement
Mix difficulty within quiz	Builds confidence
Include 2-3 question types	Varied assessment
Provide explanations	Learning opportunity
Review regularly	Keep content fresh

Engagement Strategies

1. Weekly Release Schedule

• Consistent timing builds habit
• Announcement at service
• Deadline before next service

1. Connect to Teaching

• Quiz on Sunday’s sermon
• Release Monday morning
• Reference in announcements

1. Celebrate Success

• Recognize top scorers
• Track improvements
• Award achievements

Maintenance Schedule

Task	Frequency
Review question performance	Weekly
Update outdated questions	Monthly
Create new quiz content	Weekly
Archive low-performing quizzes	Quarterly
Audit scoring accuracy	Monthly

---

Quick Reference

Quiz Creation Checklist

• [ ] Title and description complete
• [ ] Category assigned
• [ ] Difficulty level set
• [ ] Time limit configured (if applicable)
• [ ] Passing score defined
• [ ] All questions added
• [ ] Correct answers verified
• [ ] Explanations included
• [ ] Quiz previewed and tested
• [ ] Published and assigned

Question Type Selection Guide

I want to test…	Use This Type
Recall of specific facts	Multiple Choice
Comprehensive knowledge	Multiple Response
Exact memorization	Fill in the Blank
Quick fact check	True/False
Understanding of sequence	Ordering
Relationship between concepts	Matching

Difficulty Selection Guide

Student Profile	Recommended Level
New believers	Easy
Regular attendees	Easy-Medium
Active participants	Medium
Bible study members	Medium-Hard
Leaders in training	Hard
Scholars/competitors	Expert

---

Support

For additional assistance:

• Review in-app help documentation
• Contact church administrator
• Submit support ticket for technical issues

---

This SOP should be reviewed and updated quarterly to reflect feature changes and ministry needs.