Audit logging tracks all significant activity within PressPrimer Quiz, creating a detailed record for compliance requirements, troubleshooting, and accountability. Every change to quizzes, questions, groups, and settings is recorded along with who made the change and when.
What Gets Logged
The audit log captures events across several categories:
- Quizzes: Created, updated, deleted, published
- Questions: Created, updated, deleted, restored
- Question Banks: Created, updated, deleted
- Quiz Attempts: Started, submitted, graded, deleted
- Groups: Created, updated, deleted, members added/removed
- Assignments: Created, updated, deleted
- Settings: Plugin settings changed, white-label settings changed, xAPI settings changed
- Data Operations: Exports performed, imports performed
- Data Tools & Privacy: Progress resets from the free plugin’s Data Tools, and guest data erasures. Erasures are recorded without ever storing the erased email address.
- Suite Administration: Quiz template applications, spaced repetition scheduler changes and review quiz consolidation (School), group source changes (Educator’s LearnDash Groups Mode), study plan activity (plans created and completed, practice sessions finished), and changes to which question banks are open for practice
- Email Events: Campaign sends and unsubscribes from the Educator add-on. Unsubscribes are recorded without ever storing the email address.
- Integrity Review: Integrity flag acknowledgements and dismissals, including any reviewer notes
- Each log entry records the event type, the affected object, the user who performed the action, a timestamp, and relevant details about what changed.
Configuring Audit Settings
Navigate to PressPrimer Quiz > Settings and select the Audit Log tab.

Enable/Disable Categories
You can selectively enable or disable logging for specific event categories:
- Log Quiz Attempts: Track when learners start and submit quizzes. Disable if you have high quiz volume and don’t need attempt-level tracking.
- Log Question Changes: Track question creation and edits.
- Log Settings Changes: Track when plugin configuration is modified.
Retention Period
Set how long audit logs are retained before automatic cleanup. The default is 365 days. Set to 0 to keep logs indefinitely (note: this will increase database size over time). A daily background process removes entries older than the retention period.
Guest Email Retention
The same settings screen includes Guest Email Retention, which automatically erases captured guest emails after a time window you choose. There are two independent windows, both off by default: one for guests who did not give marketing consent, and one for guests who did. Since a non-consented address usually has no reason to stick around, a short window (such as 90 days) is a sensible starting point there, with a longer window, or none, for consented contacts.
Each address is classified by its latest consent event, matching how the Contacts list works, and becomes eligible once its newest capture anywhere on the site has aged past its window. A daily sweep then erases eligible addresses through the exact same erasure pathway as the WordPress privacy tools and the Erase action in Contacts. That means the cleanup is complete: the address is scrubbed from attempts, Contacts, and reports, integrity records for those attempts are removed, and the audit trail keeps only its privacy-safe record of the erasure.
Two things to know before enabling it: erasure is permanent, with no undo; and unsubscribed (do-not-email) addresses stay suppressed after erasure, because the suppression list keeps a one-way hash rather than the address itself, so an erased contact can never be accidentally re-mailed by a later campaign.
User Agent Logging
Optionally record the browser/device information for each logged event. This can help identify which device was used for a particular action but increases storage requirements.
Privacy note: IP addresses are intentionally not collected to minimize privacy concerns and reduce compliance burden under regulations like GDPR.
Viewing the Audit Trail
Navigate to PressPrimer Quiz > Reports and click the Audit Trail card.
The report displays a chronological list of all logged events with filtering options:
- Event Type: Filter by specific event types (e.g., only show question deletions)
- User: Filter by the user who performed actions
- Date Range: View events within a specific time period
- Search: Search within event details
Click any entry to expand it and view full details about what changed.
Audit Log Integrity
Audit logs are append-only by design. Once an event is logged, it cannot be modified or deleted through the normal interface. The only way entries are removed is through the automatic retention cleanup or a manual purge from the settings page. This ensures the audit trail remains a reliable record of what actually happened.
