# Taking Quizzes and Viewing Results

> **Portal:** `/lms` · **Desk:** Learning workspace

---

## Overview

Learners access quizzes through the Smooth LMS portal at `/lms`. When a lesson includes a linked **LMS Quiz**, the quiz interface renders inline—questions appear one at a time or in a scrollable form depending on UI configuration, with optional timer, attempt counter, and submission history.

This guide covers the learner experience from starting a quiz through reviewing scores, retaking when allowed, and understanding how results affect course progress and certification eligibility.

## Accessing a quiz

**From a course:**
1. Log in to `/lms` with your employee account (**LMS Student** role).
2. Open **My Courses** or follow a **Training Assignment** link.
3. Navigate the course outline; lessons with quizzes show a quiz icon or checkpoint label.
4. Open the lesson. Read content, then click **Start Quiz** when ready.

**From a cohort:**
1. Open the cohort (**LMS Batch**) from **My Cohorts**.
2. Check the **Assessments** section for scheduled quizzes.
3. Select the quiz to begin.

**Prerequisites:** You must be enrolled in the course (**LMS Enrollment**) or cohort (**LMS Batch Enrollment**). Mandatory courses may auto-enroll during HR onboarding. If you see "not enrolled," contact your trainer or HR.

## Starting and answering questions

When you click **Start Quiz**:

1. The system loads questions via `get_quiz_questions`. If **Randomize Question Order** is enabled, order shuffles each attempt. If **Questions Per Attempt** is set, you receive a random subset.
2. A timer starts when **Duration** is configured—displayed as MM:SS or HH:MM:SS. When the timer reaches zero, the quiz auto-submits.
3. Answer each question:
   - **Choices** — select one or more options
   - **True/False** — pick True or False
   - **User Input** — type your answer
   - **Open Ended** — enter a text response (may require instructor grading)

4. Navigate between questions using **Next** / **Previous** or the question list.
5. Click **Submit Quiz** when finished—or wait for auto-submit on timeout.

The client sends `started_at` timestamp for timed quizzes; late submissions beyond the grace period are rejected server-side.

## After submission: scores and feedback

Immediately after submit, you typically see:

- **Score** — points earned vs **Total Points**
- **Percentage** — compared to **Passing Percentage**
- **Pass / Fail** indicator
- **Per-question feedback** — when **Show Answers** is enabled, correct options and explanations display

Open-ended submissions may show **Pending review** until an evaluator or AI grading assigns marks. You receive a notification when grading completes.

**Submission History:** When **Show Submission History** is on, prior attempts list with date, score, and percentage—useful for tracking improvement across retakes.

## Attempts and retakes

**Max Attempts** controls retakes:

- `0` — unlimited attempts
- `N` — you may submit at most N times

The UI disables **Start Quiz** when attempts are exhausted. Contact your instructor or HR if a retake is needed for compliance (e.g., failed safety quiz)—they may delete a prior submission from desk or adjust quiz settings.

Each attempt creates a separate **LMS Quiz Submission** record. Evaluators see full history; learners see summarized history when enabled.

## How quiz results affect progress

Passing a lesson quiz updates course progress through `save_progress_after_quiz`. The **LMS Enrollment** **Progress** percentage increases as lessons complete.

Courses with **Enable Certification** may require 100% progress before certificate issuance. Failed quizzes block completion until you pass—check the course outline for incomplete checkpoints marked in red or with a lock icon.

Cohort assessments may have separate due dates on the batch dashboard; missing due dates does not always block course progress but appears in trainer reports and **Mandatory Training Compliance** analytics.

## Viewing results later

**In the portal:**
- Return to the quiz lesson—submission summary and history appear below the quiz card.
- **Quiz Results** page (if linked in sidebar) lists recent submissions across courses.

**In desk (if you have access):**
- **`/app/lms-quiz-submission`** filtered to your user shows all submissions.

Managers and HR reviewing employee compliance should use desk lists or **Statistics** dashboard—not the learner's personal view.

## Open-ended and AI-graded answers

**Open Ended** questions require human or AI evaluation:

1. Submission saves with zero or provisional marks on open rows.
2. **Batch Evaluator** opens **LMS Quiz Submission**, reviews **Result** child table, assigns **Marks** per question (cannot exceed **Marks Out Of**).
3. On save, **Score** and **Percentage** recalculate; pass/fail updates.

When AI grading is enabled, `grade_open_answer` compares the response to expected key points and returns score 0–100 with feedback—useful for high-volume training with consistent rubrics.

Learners see updated results after grading via notification and refreshed quiz lesson view.

## Tips for learners

- Read the full lesson before starting timed quizzes.
- On timed exams, answer easy questions first, then revisit flagged items if navigation allows.
- For open-ended questions, use complete sentences and reference lesson terminology—helps AI and human graders.
- If you pass, download the PDF report (see Print PDF guide) for your records.
- Failed mandatory quizzes: notify HR so [Employee Compliance](https://smoothhiring.com/help/hrms/documents-compliance/employee-compliance) status stays accurate.
- Use the **AI Training Assistant** on lesson pages to clarify concepts before attempting the quiz.

## Troubleshooting

| Issue | What to do |
|-------|------------|
| Start Quiz disabled | Attempt limit reached or no questions configured |
| Submit fails — time limit | Retake requires admin reset; request new attempt |
| Score seems wrong | Ask evaluator to verify **LMS Quiz Result** rows |
| Progress not updating | Ensure quiz passed; refresh course; contact support |
| Cannot find quiz | Confirm enrollment; course must be published |
| Page frozen during quiz | Do not refresh—may consume attempt; contact admin |

---

## Frequently asked questions

### Does LMS training completion automatically update Employee Compliance?

No. Smooth LMS tracks learning progress, quiz scores, and certificates. Smooth HR **Employee Compliance** is updated separately by HR when a regulatory or policy requirement is satisfied. Download LMS PDFs and attach them to [Employee Document](https://smoothhiring.com/help/hrms/documents-compliance/employee-documents), then mark the matching compliance row **Complete** with the correct renewal date.

### Where should quiz PDFs be stored for audits?

Use [Employee Document](https://smoothhiring.com/help/hrms/documents-compliance/employee-documents) on the employee record with an appropriate **Employee Document Type** (for example Training Record or Policy Acknowledgment). Include the **Quiz Submission Report** PDF exported from LMS. For organization-wide retention policies, align document type expiry settings with [Employee Compliance](https://smoothhiring.com/help/hrms/documents-compliance/employee-compliance) renewal periods.

### Which desk workspace manages LMS content?

Open the **Learning** workspace from the app switcher. Desk paths use `/app/list name` slugs—for example `/app/lms-quiz` and `/app/lms-enrollment`. Learners consume training at `/lms` on the same site.

### How do new hires get enrolled in mandatory training?

When **Employee Onboarding** is created in HRMS, the LMS integration enrolls the employee user in every published **Mandatory** course and creates **LMS Training Assignment** rows with default due dates. Ensure the **Employee** record has a linked **User** with the **LMS Student** role.

### What is the difference between an LMS Certificate and HR compliance?

An **LMS Certificate** proves course completion inside Smooth LMS. **Employee Compliance** in Smooth HR tracks regulatory obligations (training renewals, I-9, background checks) with scheduled expiry alerts. Course certificates do not automatically appear on the HR compliance ledger—HR attaches LMS PDFs to [Employee Document](https://smoothhiring.com/help/hrms/documents-compliance/employee-documents) and updates [Employee Compliance](https://smoothhiring.com/help/hrms/documents-compliance/employee-compliance) when policy requires.

### Can managers view their team's quiz scores?

Managers with **Moderator** or **Course Creator** roles can open **LMS Quiz Submission** list views filtered by course and member. The **Statistics** dashboard summarizes average assessment scores by course. For official personnel files, export PDFs and store under the employee's HR documents rather than sharing desk login credentials.

### Can I pause a timed quiz and resume later?

Timed quizzes run continuously from **Start Quiz** until submit or timeout. Closing the browser may not pause the server-side clock. Plan uninterrupted time equal to the configured **Duration** plus a few minutes for review before submitting.

## Glossary

| Term | Definition |
|------|------------|
| **LMS Course** | Training container with chapters, lessons, and assessments |
| **LMS Enrollment** | Links a User (employee) to a course with progress tracking |
| **LMS Quiz** | Assessment document composed of linked questions |
| **LMS Quiz Submission** | Record of one learner attempt with scored results |
| **LMS Training Assignment** | Due-date tracker for assigned mandatory training |
| **LMS Certificate** | Issued credential after course or evaluation completion |
| **Mandatory course** | Published course flagged for auto-enrollment on onboarding |
| **Cohort (LMS Batch)** | Scheduled group of learners with shared live sessions and assessments |
| **Employee Document** | HR file-cabinet record for attachments on the employee profile |
| **Employee Compliance** | HR ledger for regulatory and policy compliance status with renewals |
## Smooth LMS + Smooth HR capability map

Use **Smooth LMS** for training delivery and assessments, and **Smooth HR** for employee files and compliance records — both on the same account.

| Business need | Primary app | How |
|---------------|-------------|-----|
| Online training library | **Smooth LMS** | **LMS Course** with chapters, lessons, video/PDF/SCORM, quizzes, assignments |
| Assign training + track progress | **Smooth LMS** | **LMS Enrollment**, **LMS Training Assignment**, cohort batches, progress dashboards |
| Print completed tests as PDF | **Smooth LMS** | **LMS Quiz Submission** → **Quiz Submission Report** print format |
| Course completion certificates | **Smooth LMS** | **LMS Certificate** with customizable print templates |
| Employee file storage | **Smooth HR** | [Employee Document](https://smoothhiring.com/help/hrms/documents-compliance/employee-documents) with document types and expiry |
| Regulatory compliance tracking | **Smooth HR** | [Employee Compliance](https://smoothhiring.com/help/hrms/documents-compliance/employee-compliance) with **Compliance Type** renewals |
| New hire document collection | **Smooth HR** | **Employee Onboarding** portal + e-signatures |

Course completion certificates from LMS are separate from HR compliance records until HR explicitly files them. Attach LMS PDFs to **Employee Document** or update **Employee Compliance** when a training record must appear on the official employee file for audits.
## LMS roles reference

| Role | Capabilities |
|------|----------------|
| **System Manager** | Full desk access; configure LMS Settings, print formats, AI keys |
| **Moderator** | Manage all courses, quizzes, enrollments, certificates, statistics |
| **Course Creator** | Author courses, quizzes, assignments; view learner submissions for own content |
| **Batch Evaluator** | Grade submissions, conduct certificate evaluations, manage cohort assessments |
| **LMS Student** | Access `/lms` portal; take quizzes; view own certificates and assignments |

HR users without LMS roles can still manage [Employee Document](https://smoothhiring.com/help/hrms/documents-compliance/employee-documents) and [Employee Compliance](https://smoothhiring.com/help/hrms/documents-compliance/employee-compliance) records when L&D provides exported PDFs.
## Connecting training records to Smooth HR

Smooth LMS and Smooth HR share one account. Completing a course does not automatically update HR compliance—you connect the two when your policy requires it.

| LMS artifact | HR destination | When to use |
|--------------|----------------|-------------|
| **LMS Certificate** PDF | [Employee Document](https://smoothhiring.com/help/hrms/documents-compliance/employee-documents) | Store course completion certificate on the employee file |
| **Quiz Submission Report** PDF | [Employee Document](https://smoothhiring.com/help/hrms/documents-compliance/employee-documents) | Retain scored test results (safety quizzes, policy acknowledgments) |
| Mandatory training status | [Employee Compliance](https://smoothhiring.com/help/hrms/documents-compliance/employee-compliance) | Track renewal dates, expiry alerts, and audit-ready compliance status |

**Recommended workflow:** When an employee completes mandatory training and passes required assessments, download the LMS certificate or quiz PDF from the Learning portal or desk, then attach it to an **Employee Document** or update the corresponding **Employee Compliance** record. HR Managers can configure **Compliance Type** with renewal periods so expiring certifications trigger scheduled reminders—complementing LMS **Training Assignment** due dates.

New hires enrolled via **Employee Onboarding** may receive automatic LMS enrollments for courses marked **Mandatory**; HR still uses **Employee Compliance** for regulatory items (I-9, background checks) that live outside LMS.
---

## Related guides

- [Print PDF Quiz Reports](https://smoothhiring.com/help/lms/assessments/quizzes/print-pdf-report)
- [Quizzes Overview](https://smoothhiring.com/help/lms/assessments/quizzes/overview)
- [AI Tutor](https://smoothhiring.com/help/lms/ai/ai-tutor)

---

_Last updated: May 2026_