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 records when policy requires retained proof of training assessments. Compliance officers pair them with 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:
- Complete the quiz or open a past submission from the lesson view.
- Click Download PDF on the quiz results panel.
- The browser downloads
{quiz-title}-quiz-report.pdf.
All course quizzes:
- From Quiz Results or course progress view, click Download Course PDF.
- System resolves your LMS Enrollment and generates Course Quiz Results Report.
- 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:
- Open
/app/lms-quiz-submission. - Select the submission record.
- Click Download PDF on the toolbar (custom button).
- 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):
- Open
/app/lms-enrollmentfor the employee's enrollment. - Use Download Course Quiz PDF custom button if present.
- 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:
- Employee completes mandatory quiz in LMS.
- HR or employee downloads Quiz Submission Report PDF.
- Create Employee Document on the employee record:
- Document Type — Training Certificate / Policy Acknowledgment / custom type
- Attach PDF
- Set Expiry Date if training renews annually
- 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 and 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 submissiondownload_quiz_submission_pdf(name, print_format='Quiz Submission Report')get_course_quiz_results_urls(course, member)— enrollment-level URLsdownload_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, then mark the matching compliance row Complete with the correct renewal date.
Where should quiz PDFs be stored for audits?
Use Employee Document 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 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 and updates 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 with document types and expiry |
| Regulatory compliance tracking | Smooth HR | 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 and 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 | Store course completion certificate on the employee file |
| Quiz Submission Report PDF | Employee Document | Retain scored test results (safety quizzes, policy acknowledgments) |
| Mandatory training status | 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
Last updated: May 2026