Designing quizzes and certifications

The Quiz Builder feature in BlueDocs allows you to create interactive assessments tied to your training documents. Quizzes help you verify that team members have understood the content they've studied, ensuring compliance and knowledge retention across your organization.

Key Benefits

• Validate Learning: Confirm that employees truly understand training material
• Track Progress: Monitor who has completed training and how well they performed
• Ensure Compliance: Document that required training has been comprehended
• Flexible Assessment: Choose from multiple question types to test different knowledge areas

Getting Started with Quizzes

Accessing Quiz Settings

1. Navigate to Settings in the left sidebar
2. Click on the Quiz Settings tab
3. You'll see a list of all your training documents
4. Each document shows its current quiz status (either "No Quiz" or the number of quizzes attached)

Creating Your First Quiz

1. From the Quiz Settings page, locate the training document you want to add a quiz to
2. Click the "Create Quiz" or "Manage Quiz" button
3. On the Quiz Management screen, click "Create Quiz"
4. You'll be taken to the Quiz Builder interface

Building Your Quiz

The Quiz Builder has two main tabs: Quiz Settings and Quiz Questions.

Quiz Settings Tab

This is where you configure the overall behavior of your quiz.

Basic Information

• Quiz Title (Required): Give your quiz a clear, descriptive name
• Description (Optional): Provide context about what the quiz covers

Scoring & Attempts

• Pass Rate (%): Set the minimum score required to pass (e.g., 60%, 80%)
• Users must score at or above this percentage to pass the quiz
• Maximum Attempts: Control how many times a user can take the quiz
• Set to 1 for single-attempt quizzes
• Set to 0 for unlimited attempts
• Or choose any specific number (2, 3, 5, etc.)

Quiz Options

Configure how users experience the quiz:

• Show Feedback: Display whether each answer was correct or incorrect after completion
• Show Correct Answers: Reveal the right answers after the quiz is submitted
• Randomize Questions: Present questions in random order to each user
• Randomize Answers: Shuffle multiple choice answer options randomly
• Active: Toggle whether this quiz is currently available to users

Quiz Questions Tab

This is where you build the actual assessment by adding questions.

Question Toolbox

On the left side, you'll see a toolbox with five question types. Simply drag a question type into the questions area to add it:

1. Single Choice (Multiple Choice - One Answer)

• Present 4+ options with radio buttons
• Only one answer can be correct
• Perfect for: "Which of the following..."

2. Multiple Choice (Multiple Correct Answers)

• Present 4+ options with checkboxes
• Multiple answers can be correct
• Perfect for: "Select all that apply..."

3. True/False

• Simple binary choice
• Great for fact verification
• Users select True or False

4. Short Text

• Users type in their answer
• You define accepted answers
• Choose between:
• Contains keyword: Answer must include certain words
• Exact match: Answer must match exactly
• Case sensitive: Whether capitalization matters
• You can provide multiple acceptable variations

5. Numeric

• Users enter a number
• Define either:
• An exact value required
• A range of acceptable values (min/max)
• Whether to allow decimals

Configuring Each Question

For every question you add, you can set:

• Question Text: The actual question being asked
• Question Type: Choose from the 5 types above
• Points: How much this question is worth (allows weighted scoring)
• Explanation (Optional): Feedback shown after submission if "Show Feedback" is enabled
• Hint (Optional): Help text users can view while taking the quiz

Managing Question Options

For Multiple Choice and True/False questions:

• Add Option: Click "+ Add Option" to add more choices
• Mark Correct: Click the radio button (Single Choice) or checkbox (Multiple Choice) to mark correct answers
• Delete Option: Click the trash icon to remove an option
• Reorder Questions: Drag the handle icon to rearrange question order

Preview & Save

Preview Your Quiz

Before publishing, click the Preview button to:

• Experience the quiz as a user would
• Test all questions and answers
• Verify scoring logic
• Check the user experience

Saving Your Quiz

Once you're satisfied with your quiz:

1. Click Save Quiz in the top right
2. Your quiz is now attached to the training document
3. Users who complete the training will see the quiz unlock

How Users Experience Quizzes

Quiz Unlock Requirements

• Users must first complete all training modules in the document
• Once complete, the quiz becomes available
• A quiz button or notification appears on the training document

Taking the Quiz

When a user starts a quiz:

1. They see the quiz title, description, and pass rate
2. A progress bar shows how many questions they've answered
3. They can navigate between questions using Previous/Next buttons
4. A question navigator shows all questions and which are completed
5. Optional hints may be available on questions
6. Once all questions are answered, they can submit

Important Rules

• No Cheating: Once the quiz starts, users cannot return to the training content
• Exit Warning: If a user tries to close the quiz mid-attempt (and only 1 attempt is allowed), they'll see a warning that this will count as a failed attempt
• Time Tracking: The system records how long each attempt takes

Results

After submission:

• Users immediately see if they passed or failed
• Their score percentage is displayed
• If enabled, they see feedback on each question
• If enabled, correct answers are revealed
• A "Passed" badge appears on the training document if successful

Viewing Quiz Results

Attempts Tab

From the Quiz Management screen, click the "View Attempts" tab to see:

For Each Attempt:

• User name
• Attempt number (1, 2, 3, etc.)
• Status (In Progress, Passed, Failed, Abandoned)
• Score percentage
• Time taken to complete
• When it was started
• When it was completed

Actions Available:

• View Details: See the full breakdown of answers
• Reset User Attempts: Allow a user to retake the quiz regardless of attempt limits
• Delete Attempt: Remove an attempt record (use with caution)

Editing & Managing Quizzes

Editing an Existing Quiz

1. Go to Settings → Quiz Settings
2. Click "Manage Quiz" on the relevant document
3. Click the ⋮ (three dots) menu next to your quiz
4. Select "Edit Quiz"
5. Make your changes in the Quiz Builder
6. Click Save Quiz

Deleting a Quiz

1. In the Quiz Management view, click the ⋮ menu
2. Select "Delete Quiz"
3. Confirm the deletion
4. ⚠️ Warning: This permanently removes all quiz data, questions, and attempt history

Best Practices

Question Design

✅ Do:

• Write clear, unambiguous questions
• Use a mix of question types to test different knowledge areas
• Assign higher points to more important or difficult questions
• Provide hints for complex questions
• Write explanations to help users learn from mistakes

❌ Don't:

• Make questions too easy or too obvious
• Use trick questions that test reading comprehension rather than knowledge
• Create extremely long questions that are hard to read

Quiz Configuration

✅ Do:

• Set realistic pass rates (60-80% is common)
• Allow multiple attempts for complex training (2-3 attempts)
• Enable feedback and correct answers for learning-focused quizzes
• Randomize questions for high-stakes assessments
• Use single attempts for compliance certification

❌ Don't:

• Set pass rates at 100% unless absolutely necessary
• Disable feedback on learning-focused training
• Create quizzes with only 1-2 questions
• Make every question worth the same points if some are more important

Content Strategy

✅ Do:

• Align quiz questions directly with training content
• Include questions that test practical application, not just memorization
• Update quizzes when training materials change
• Test your quiz before making it live

Troubleshooting

"User can't see the quiz"

• Verify the quiz is set to Active in Quiz Settings
• Confirm the user has completed all training modules
• Check that the quiz is properly assigned to the document

"User exceeded attempts but needs to retake"

• Use the Reset User Attempts option in the Attempts tab
• This will allow them to try again regardless of the attempt limit

"Need to update questions after users have taken quiz"

• You can edit questions at any time
• Previous attempt scores remain unchanged
• New attempts will use the updated questions

Support & Additional Help

If you have questions about creating or managing quizzes, contact your BlueDocs administrator or support team. Remember, effective quizzes help ensure your team truly understands critical training content and maintains compliance standards.

Updated on: 11/11/2025