View the Audit Log

Summary

The Audit Log page shows a chronological record of system activity across your organisation. Use it to track who did what, when, and from where. You can filter by date range, entity type, user, and action, then export the results as CSV or JSON.

Prerequisites

You are signed in as an Owner or Manager.
You have the audit.view capability.
To export, you also need the audit.export capability.

Permissions

Owner / Manager: Can view and filter the audit log. Can export to CSV and JSON.
Other roles: No access. Redirected to Settings.

Steps

View the audit log

Select Settings from the sidebar.
Select Audit Log. The page heading reads “Audit Log” with the subtitle “View system activity and audit trail”.
By default, the log shows the last 7 days of entries, paginated at 50 per page.
The total entry count appears to the right of the filter bar (e.g. “142 entries”).

Read an audit entry

Each row in the table shows:

Timestamp - date and time in “MMM d, HH:mm:ss” format.
User - the email address of the user who performed the action, or “System” for automated actions.
Action - a badge showing the action type (e.g. Created, Updated, Deleted).
Entity - the type of record affected (e.g. Work Order, Quote, Time Entry).
IP Address - the IP address of the request (visible on wider screens).

Select a row to expand it. The expanded view shows:

Entity ID - the unique identifier of the affected record.
Role - the user’s role at the time of the action.
Reason - if a reason was provided (e.g. for a time entry edit), it appears in a highlighted card.
Changes - a before-and-after comparison of changed fields, with old values struck through in red and new values in green.
Deleted Entry Details - for delete actions, the full details of the deleted record.
Photo - if a verification photo exists (e.g. time clock entries), a “View verification photo” link opens a lightbox.
Device info - IP address, user agent, device fingerprint, and geolocation data where available.

Filter the audit log

Select the Filter button (with filter icon) to open the filter popover.
Set any combination of filters:
- Date Range - select a start and end date using the calendar pickers. Dates cannot be in the future.
- Entity Type - select from a dropdown of entity types that appear in your logs (e.g. Work Order, Quote, Invoice, Time Entry).
- User - select a specific user from the dropdown. Only users with audit entries appear.
- Action - select a specific action type (e.g. Created, Updated, Deleted).
Select Apply to run the filter.
An “Active” badge appears on the Filter button when filters are applied.
Select Clear (next to the Filter button, or inside the popover) to reset all filters.

Navigate pages

The page count appears at the bottom left (e.g. “Page 1 of 3”).
Use the left and right arrow buttons to move between pages.
Changing filters resets to page 1.

Export the audit log

Apply any filters you want (the export respects current filters).
Select the CSV button to download a CSV file. The file is named audit-log-YYYY-MM-DD.csv.
Or select the JSON button to download a JSON file with full metadata, device info, and photo paths. The file is named audit-log-YYYY-MM-DD.json.
Exports are capped at 10,000 records for safety.
A success toast confirms the download.

Expected Outcome

The audit log displays a filterable, paginated table of all system activity.
Expanded rows show full details including field-level changes.
CSV and JSON exports download with the current filter applied.

Troubleshooting

Problem	Cause	Fix
”No Audit Entries” empty state	No entries match your filters, or no entries recorded yet	Clear filters and widen the date range
Cannot see the Audit Log in the sidebar	Your role lacks the `audit.view` capability	Contact the Owner to check your role permissions
Export button is greyed out	There are 0 entries matching the current filters	Adjust filters to include entries, then try again
”Not authorized to export audit logs” error	Your role lacks the `audit.export` capability	Contact the Owner to grant export permission
Expanded row shows no changes	The action did not record field-level changes (e.g. a simple status transition)	This is expected for some action types

Notes

This is the general system audit log. For AI-specific interaction logs, see Settings > AI Settings, which has its own audit trail section.
The audit log records actions across all areas: work orders, quotes, invoices, time entries, settings changes, and more.
IP address and user agent are captured automatically on each action for compliance.
The JSON export includes richer data than the CSV, including full metadata objects and device fingerprints.