# Print and PDF Quiz Reports

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

---

## Overview

Smooth LMS provides audit-ready **PDF exports** of quiz submissions—showing each question, the learner's answer, correct answers (when applicable), marks, and overall score. These reports use the **Quiz Submission Report** print format by default, with an optional **Course Quiz Results Report** that aggregates all quiz results for one enrollment.

HR teams attach these PDFs to [Employee Document](https://smoothhiring.com/help/hrms/documents-compliance/employee-documents) records when policy requires retained proof of training assessments. Compliance officers pair them with [Employee Compliance](https://smoothhiring.com/help/hrms/documents-compliance/employee-compliance) entries for safety, harassment prevention, and other mandated programs.

## Print formats available

| Format | Record | Contents |
|--------|---------|----------|
| **Quiz Submission Report** | LMS Quiz Submission | Single attempt: Q&A, scores, pass/fail |
| **Course Quiz Results Report** | LMS Enrollment | All quiz submissions for one employee in one course |

Both formats render without letterhead by default (`no_letterhead=1`) for cleaner archival PDFs. PDF generation uses your site's configured print engine.

## Download PDF from the learner portal

**Single quiz submission:**
1. Complete the quiz or open a past submission from the lesson view.
2. Click **Download PDF** on the quiz results panel.
3. The browser downloads `{quiz-title}-quiz-report.pdf`.

**All course quizzes:**
1. From **Quiz Results** or course progress view, click **Download Course PDF**.
2. System resolves your **LMS Enrollment** and generates **Course Quiz Results Report**.
3. Filename pattern: `{{course}}-{{employee}}-quiz-results.pdf`.

Portal buttons call `lms.lms.print_utils.download_quiz_submission_pdf` and `download_course_quiz_results_pdf` APIs.

## Download PDF from the desk

**LMS Quiz Submission:**
1. Open **`/app/lms-quiz-submission`**.
2. Select the submission record.
3. Click **Download PDF** on the toolbar (custom button).
4. Alternatively use **Print** → choose **Quiz Submission Report** → browser Print to PDF.

Keyboard shortcut: desk list view shows hint—open any row and use Print or Download PDF; **Ctrl+Shift+Q** returns to quiz submissions list from anywhere in desk (when configured).

**LMS Enrollment (course rollup):**
1. Open **`/app/lms-enrollment`** for the employee's enrollment.
2. Use **Download Course Quiz PDF** custom button if present.
3. API: `download_course_quiz_results_pdf?enrollment={name}`

## Permissions and security

Print and PDF require **print** permission on the underlying document. Learners can export their own submissions; they cannot access other employees' reports.

`get_quiz_submission_print_url` verifies `has_lms_access()` and ownership—or elevated print permission for trainers/HR.

HR administrators auditing files should use desk with appropriate roles (**Moderator**, **HR Manager**) rather than sharing portal credentials.

## What appears on the report

**Quiz Submission Report** typically includes:

- Quiz title and course
- Member name and submission date
- Overall score, percentage, passing threshold, pass/fail
- Table of questions with:
  - Question text
  - Learner answer
  - Correct answer (when show answers policy allows)
  - Marks awarded vs marks possible

**Course Quiz Results Report** repeats submission summaries for each quiz in the course linked to the enrollment—ideal for onboarding packets filed under **Employee Document** type "Training Record."

## Filing in Smooth HR

Recommended HR workflow:

1. Employee completes mandatory quiz in LMS.
2. HR or employee downloads **Quiz Submission Report** PDF.
3. Create **Employee Document** on the employee record:
   - **Document Type** — Training Certificate / Policy Acknowledgment / custom type
   - Attach PDF
   - Set **Expiry Date** if training renews annually
4. Update linked **Employee Compliance** row to **Complete** with matching dates.

LMS certificates and quiz PDFs are separate artifacts—certificates prove course completion; quiz PDFs prove assessment performance. Some audits require both.

See [Employee Documents](https://smoothhiring.com/help/hrms/documents-compliance/employee-documents) and [Employee Compliance](https://smoothhiring.com/help/hrms/documents-compliance/employee-compliance) for HR-side configuration.

## Customization

Administrators can duplicate **Quiz Submission Report** in **Print Format** list and customize Jinja HTML under `lms/lms/print_format/quiz_submission_report/`.

Add company logo, legal disclaimers, or witness signature lines for regulated industries. Set the copy as default on **LMS Quiz Submission** via **Default Print Format** property.

Test PDF output after customization—wkhtmltopdf handles CSS differently than browser print.

## API reference for integrations

Whitelisted methods in `lms.lms.print_utils`:

- `get_quiz_submission_print_url(quiz, member)` — returns print and PDF URLs for latest submission
- `download_quiz_submission_pdf(name, print_format='Quiz Submission Report')`
- `get_course_quiz_results_urls(course, member)` — enrollment-level URLs
- `download_course_quiz_results_pdf(enrollment, print_format='Course Quiz Results Report')`

Your IT team can attach generated PDFs to employee files in Smooth HR using the same print layouts—contact Smooth support for integration help.

## Troubleshooting

| Issue | What to do |
|-------|------------|
| PDF blank or broken images | Disable letterhead; contact Smooth support |
| Download 403 | Verify user permissions; use desk as HR admin |
| No submission found | Learner must complete quiz first |
| Wrong attempt exported | API returns latest submission by creation desc |
| Chrome generator fails | Falls back to wkhtmltopdf automatically |
| Course PDF missing quizzes | Quizzes must have submissions for that member/course |

---

## 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.

## 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

- [Taking Quizzes and Results](https://smoothhiring.com/help/lms/assessments/quizzes/taking-and-results)
- [Employee Documents (HRMS)](https://smoothhiring.com/help/hrms/documents-compliance/employee-documents)
- [Employee Compliance (HRMS)](https://smoothhiring.com/help/hrms/documents-compliance/employee-compliance)

---

_Last updated: May 2026_