View Setup Audit Trail
View Setup Audit Trail is a Setup page that displays a log of the most recent 20 setup changes made in the org (with the ability to download the last 180 days of changes as a CSV).
Definition
View Setup Audit Trail is a Setup page that displays a log of the most recent 20 setup changes made in the org (with the ability to download the last 180 days of changes as a CSV). It records who made each change, what was changed, and when, providing an audit trail for configuration governance.
In plain English
“Here's a simple way to think about it: View Setup Audit Trail is the canonical record of who changed what in Setup. Last 20 changes inline, last 180 days downloadable. The answer to "why did this configuration suddenly behave differently?"”
Worked example
After users report that a validation rule on the Case object is suddenly blocking their saves, the admin at Helios Energy checks View Setup Audit Trail. She sees that a junior admin changed the validation rule 30 minutes ago. She clicks on the entry to see what was modified, contacts the admin, and reverts the unintended change within minutes.
Why View Setup Audit Trail is the canonical record of who changed what in Setup
Setup changes - every modified Profile, every new field, every updated workflow - are logged automatically by the platform. View Setup Audit Trail is the page that surfaces those logs. The most recent 20 changes appear inline, and the last 180 days are downloadable as CSV. For an admin debugging why a configuration suddenly behaves differently, this is the canonical answer.
The reason it's worth knowing about even if you don't expect to need it is that you'll need it the day you didn't expect to. A Profile that suddenly has different access, a workflow that started behaving wrong yesterday, a sandbox refresh that wiped a setting nobody documented - each is an investigation that begins here. The Audit Trail Export Dashboard provides a richer interface; this page is the simpler always-available view. Bookmark it, and download the CSV at quarterly cadence so you have records older than the platform's 180-day cap.
How to set up View Setup Audit Trail
Setup Audit Trail is the read-only log of every Setup change — who edited which Profile, when a Validation Rule was deactivated, when a User was created. It's the compliance/forensics record of what's been done in Setup. Like Login History, it's always on; you just access it.
- Open Setup → View Setup Audit Trail
Setup gear → Quick Find: View Setup Audit Trail → View Setup Audit Trail.
- Review the default view
Last 6 months of Setup changes, sorted newest-first. Each row: Action, Date, Section, Modified By, Delegate User.
- Search for a specific change
Use the browser's Find (Cmd+F) — there's no built-in search beyond Section filters.
- Download the file (link at bottom of page)
CSV of the last 180 days. Useful for compliance archives.
- For 6+ month retention: enable Field Audit Trail or scripted export
Setup Audit Trail is 6 months only. For longer retention, schedule a download or use an extension app.
Filter by Setup category — Apex, Custom Objects, Profiles, Sharing Rules, etc.
Filter to changes by a specific user. Useful for auditing one admin's activity.
When a user is logged in via Login As, both the actor and the delegator are logged.
CSV of the last 180 days. Re-download monthly to maintain a longer archive.
- Setup Audit Trail is 6 months only. Compliance regimes (SOX, HIPAA) typically require 7 years — schedule a recurring download to S3 or a SIEM.
- It logs Setup changes only — not data changes. To audit "Who changed Account.Industry?" use Field History Tracking on the field instead.
- Login As actions are logged with both the delegator and the impersonated user. "Who really did this" requires checking both columns — easy to miss in a quick scan.
How organizations use View Setup Audit Trail
Caught a configuration drift through Audit Trail; rolled back via the historical record before user impact.
Compliance reviews use the trail as evidence; configuration changes auditable per-user, per-action.
Trust & references
Straight from the source - Salesforce's reference material on View Setup Audit Trail.
- Monitor Setup Changes with Setup Audit TrailSalesforce Help
🧠 Test your knowledge
Q1. What is the primary benefit of View Setup Audit Trail for Salesforce administrators?
Q2. Why is understanding View Setup Audit Trail important for Salesforce admins?
Q3. Can a Salesforce admin configure View Setup Audit Trail without writing code?
Discussion
Loading discussion…