← All articlesUmbraco

Audit Log Viewer for Umbraco 17

Search content changes and user audit events in the backoffice, with detailed filters, entity links and CSV export.

Who changed this page? When was that Media item deleted? Which user performed an action? Umbraco records a lot of useful history, but finding the relevant entry is often the part that takes time.

Diplo Audit Log Viewer brings that history into two searchable views in the Settings section: Content Log and Audit Trail. The Umbraco 17 version runs on .NET 10, with a backoffice rebuilt using Lit and TypeScript.

Content Log: follow changes to your site

The Content Log shows entries from Umbraco’s umbracoLog table. You can narrow the list by action, entity type, user, node, search term or date range. Date presets help you focus quickly on a particular period.

If you know the page’s name, node autocomplete helps you find it. If you already have its numeric ID, you can enter that directly instead.

Expand an entry to see its comments, parameters, entity type, node key, document type and status. The view also indicates whether the logged node still exists, which helps explain why an old entry may no longer lead to a live item.

Where supported, you can open the logged entity in an Umbraco side workspace. Contextual opening covers documents, media, members, document types, data types, templates and partial views, letting you inspect an item while keeping its history in view.

Audit Trail: investigate user events

The Audit Trail shows records from the separate umbracoAudit table. Its filters are tailored to those events: event type, performer, affected user, performer IP address, search term and date range, including date presets.

That distinction matters when the person carrying out an action and the user affected by it are different people. Expanded rows show both, alongside stable user keys, the IP address, event type and recorded details.

Together, the two views help you investigate content actions and user audit events without treating them as one undifferentiated list.

Search and export the relevant records

Both views use server-side paging, searching, sorting and filtering. You can narrow down the records in the backoffice rather than loading the whole history into the browser.

CSV export lets you download either the current page or all rows matching your filters. That can be useful for investigating an incident, reviewing a period of activity or working through records outside Umbraco.

Export is enabled by default. If you don’t want the buttons shown in the backoffice, set AuditLogViewer:DisableExport to true in your application settings. This controls the export UI.

Get started

Install the package version that matches your site. The version described here targets Umbraco 17 and .NET 10:

dotnet add package Diplo.AuditLogViewer

Open Settings → Audit Log Viewer to find Content Log and Audit Trail. The package’s Management API endpoints require Settings-section backoffice access.

The viewer reads Umbraco’s own log tables, so the history available is the history those tables contain. For application errors and diagnostic JSON logs, see the Log Browser in God Mode.

Visit the Audit Log Viewer package page for downloads, Umbraco Marketplace for the listing, or the project README for configuration and technical details.