Simple History – Track, Log, and Audit WordPress Changes

Opis

„So far the best and most comprehensive logging plugin”@herrschuessler

Simple History shows recent changes made within WordPress, directly on your dashboard or on a separate page.

The plugin acts as an audit log of the most important events that occur in WordPress.

It’s a plugin that is good to have on websites where several people are involved in editing the content.

No coding is required to use the plugin. Just install it and it will start logging events.

🔍 How Simple History Helps in Real Situations

Track what’s happening on your site
„Has someone done anything today? Ah, Sarah uploaded the new press release and created an article for it. Great! Now I don’t have to do that.”

Identify issues and debug faster
„The site feels slow since yesterday. Has anyone done anything special? … Ah, Steven activated 'naughty-plugin-x’, that must be it.”

Keep Freelancers & Agencies Accountable
„I hired a developer to optimize my site. But did they actually do anything? A quick glance at Simple History shows me exactly what they worked on, so I know I’m getting my money’s worth!”

✨ Simple History Features

Out of the box Simple History has support for:

  • Posts and pages – see who added, updated or deleted a post or page

  • Attachments – see who added, updated or deleted an attachment

  • Taxonomies (Custom taxonomies, categories, tags) – see who added, updated or deleted an taxonomy

  • Comments – see who edited, approved or removed a comment

  • Widgets – get info when someone adds, updates or removes a widget in a sidebar

  • Plugins – activation and deactivation

  • User profiles – info about added, updated or removed users

  • User logins – see when a user login & logout. Also see when a user fails to login (good way to catch brute-force login attempts).

  • User edits – see when a user is added, updated or removed, and get detailed information about the changes made to the user.

  • Failed user logins – see when someone has tried to log in, but failed. The log will then include ip address of the possible hacker.

  • Menu edits

  • Option screens – view details about changes made in the different settings sections of WordPress. Things like changes to the site title and the permalink structure will be logged.

  • Privacy page – when a privacy page is created or set to a new page.

  • Data Export – see when a privacy data export request is added and when this request is approved by the user, downloaded by an admin, or emailed to the user.

  • User Data Erasure Requests – see when a user privacy data export request is added and when this request is approved by the user and when the user data is removed.

Built-in logging for third-party plugins

Simple History comes with built in support for many plugins:

  • Jetpack – See which Jetpack modules are activated and deactivated.

  • Advanced Custom Fields (ACF) – See when field groups and fields are created and modified.

  • User Switching – See each user switch being made.

  • WP Crontrol – See when cron events are added, edited, deleted, paused, resumed, and manually ran, and when cron schedules are added and deleted.

  • Enable Media Replace – See details about the file being replaced and details about the new file.

  • Limit Login Attempts – See login attempts, lockouts, and configuration changes made in the plugin Limit Login Attempts.

  • Redirection – See redirects and groups that are created, changed, enabled or disabled and also when the global plugin settings have been modified.

  • Duplicate Post –See when a clone of a post or page is done.

  • Beaver Builder – See when a Beaver Builder layout or template is saved or when the settings for the plugins are saved.

Is your plugin missing? No problem – plugin authors can add support for Simple History in their plugins using the logging API.

Plugins that have support for Simple History includes:

💬 What users say

🌟 300+ five-star reviews speak to the reliability of this plugin. 🌟

  • „The best history plugin I’ve found”Rich Mehta

  • „Custom Logs Are Crazy Awesome!”Ahmad Awais

  • „Amazing activity logging plugin”digidestination

  • „Fantastic plugin I use on all sites”Duncan Michael-MacGregor

  • „Useful Quick View of Activity”Dan O

  • „The best Activity Plugin”Rahim

  • „The best free history plugin ever”abazeed

  • „It is a standard plugin for all of our sites”Mr Tibbs

Getting Started

After installation, Simple History automatically starts logging activities. Access the history log through the dashboard widget or via the 'Simple History’ page.

RSS feed with changes

Using the optional password protected RSS feed you can keep track of the changes made on your website using your favorite RSS reader.

WP-CLI commands for automation

Multiple WP-CLI commands exist, to view and search the log, and to view more information about a specific event.

WP-CLI support is perfect for system administrators and agencies managing multiple WordPress sites. Using WP-CLI commands they can automate log monitoring, create reports, or integrate with existing DevOps tools.

Example commands:

  • wp simple-history event list – List the latest logged events.
  • wp simple-history event search – Search for events.

Stealth Mode – Hide Simple History from the WordPress Admin

Stealth Mode allows Simple History to run completely in the background, hidden from the WordPress admin interface. This is ideal for agencies, developers, and administrators who want to track user activity discreetly without exposing the logs to other users.

There are two modes:

  • Full Stealth Mode – Completely hides Simple History from everyone.
  • Partial Stealth Mode – Hides the plugin but allows selected users to access the logs.

The activity log remains accessible via the REST API, WP-CLI, and RSS feed, ensuring administrators can still retrieve logs when needed.

Stealth Mode is enabled using a constant or filter, allowing you to customize who can access the logs while keeping the plugin hidden in the admin interface.

📝 Add your own events to the log using the API

Theme and plugin developers can log custom events in Simple History using the simple_history_log filter:

apply_filters(
  'simple_history_log',
  'This is a logged message'
);

See the documentation for examples on how to log your own events, query the log, and more.

🔆 Extend with Add-ons

Take your activity logging to the next level with add-ons that enhance tracking, security, and customization.

Simple History Premium

Unlock advanced features and customization options:

  • Log Retention – Control how long logs are stored, from a few days to forever.
  • Export Search Results – Download logs in CSV or JSON format for deeper analysis.
  • Failed User Logins – Disable or limit logging of failed login attempts to reduce noise.
  • IP Address Anonymization – Choose whether to store full IPs or anonymize them for privacy compliance (e.g., GDPR).
  • Login Location Lookup – View the location of a specific login attempt on Google Maps to identify suspicious activity.
  • Logger Control – Enable or disable specific loggers to manage what type of events are recorded.
  • Ad-Free Experience – Remove promotional banners for a distraction-free workflow.

WooCommerce Logger

Track WooCommerce activity with detailed logs for:

✔️ Orders, refunds, and stock changes
✔️ Product updates and pricing adjustments
✔️ Settings modifications and coupon usage

Debug and Monitor

Gain deeper insights into your site’s background activity:

🛠️ Monitor outgoing requests and emails
🔍 Debug HTTP API calls and server communication
👨‍💻 Essential for developers, support teams, and anyone curious about what’s happening under the hood

💚 Sponsor this project

If you like this plugin please consider donating to support the development of the free plugin. The plugin has been free for the last 10 years and will continue to be free.

Zrzuty ekranu

  • The log view + it also shows the filter function in use – the log only shows event that are of type post and pages and media (i.e. images & other uploads), and only events initiated by a specific user.

  • The Post Quick Diff feature will make it quick and easy for a user of a site to see what updates other users have done to posts and pages.

  • When users are created or changed you can see details on what have changed.

  • Events have context with extra details – Each logged event can include useful rich formatted extra information. For example: a plugin install can contain author info and a the url to the plugin, and an uploaded image can contain a thumbnail of the image.

  • Click on the IP address of an entry to view the location of for example a failed login attempt.

  • See even more details about a logged event (by clicking on the date and time of the event).

  • A chart with some quick statistics is available, so you can see the number of events that has been logged each day. A simple way to see any uncommon activity, for example an increased number of logins or similar.

Najczęściej zadawane pytania

Is the plugin free?

Yes! Simple History has been free for over 10 years and will remain free. To support development and unlock extra features, you can purchase add-ons. View add-ons.

How do I view the log?

You can access the log in multiple ways:

  • The dashboard widget
  • The admin bar menu
  • A dedicated log page in the WordPress admin area

Do I need coding skills to use the plugin?

No! Just install and activate the plugin, and it will start collecting activity logs automatically.

Where is the log stored?

The log is stored in your WordPress database.

Can I export the log?

Yes, you can export logs in CSV or JSON format for further analysis.

Is it compatible with other plugins?

Yes! Simple History supports many popular plugins out of the box. Additionally, developers can integrate it with any plugin using the Logging API.

Will this plugin slow down my website?

No, Simple History is lightweight and optimized for performance. Most logging occurs in the WordPress admin area when a WordPress user performs an action.

By default, nothing is logged on the front end, ensuring visitors experience no impact on performance.

Who can view the log?

Access to the log depends on the user’s role:

  • Administrators can view all logged events.
  • Editors can see events related to posts and pages.

Can I exclude certain users from being logged?

Yes, you can exclude users based on role or email using the simple_history/log/do_log filter.

For more details, check the hooks documentation.

How long is the history kept?

By default, logs are stored for 60 days. You can change this in the settings.

You can also adjust the retention period using the simple_history/db_purge_days_interval filter or the Extended Settings add-on.

Can I track changes made by specific users?

Yes! You can filter logs by username, making it easy to track individual activity.

Is this plugin GDPR compliant?

GDPR compliance depends on how you use the plugin and how you handle collected data. WordPress guidelines prohibit plugins from making legal compliance claims, so you should review your site’s data policies to ensure compliance.

That said, Simple History follows privacy-friendly practices:

  • ❌ No Google Fonts
  • ❌ No cookies
  • ❌ No local storage
  • ✅ IP addresses are anonymized by default

Since the plugin logs events (which may contain personal data), it’s your responsibility to ensure GDPR compliance based on your site’s usage.

For more information, see the full GDPR FAQ.

Recenzje

2025-02-04
I have a small number of plugins I install immediately on every site, and this is one of them. Just like the name says, it’s simple, but provides a critical record of changes made on the site. I recently used it to resolve a massive issue where a client had deleted a user and inadvertently deleted all of their content. This plugin didn’t restore the content, of course — that’s not what it’s intended to do — but it helped me solve the mystery of what had happened, since the client didn’t understand what they had done. So… install Simple History on your site! (And keep good backups. That was the rest of the story.)
2025-01-27 2 odpowiedzi
Since one of the recent updates, the plugin creates new menu items almost everywhere per default. While it used to have a single menu element below „Dashboard” (which is great), it now not only appears in the dashboard menu but also in the admin bar and even creates a new top level settings page. Settings pages belong under the „settings” menu and not as a new top level item. Also, I think its bad practice to introduce such major visual changes and activate them per default. I hope they change this behavior, move the settings menu, or at least disable the new items per default. EDIT: Upgraded the rating. Please consider the backend menu logic though for further updates. Thanks.
2025-01-27 1 odpowiedź
Great history plugin that is updated frequently.It’s simple to use, has a clean interface and just works.Very easy to recommend. The addition of stealth mode in 5.6.0 was excellent, as this isn’t really information dashboard end users need.
Przeczytaj 390 recenzji

Kontrybutorzy i deweloperzy

„Simple History – Track, Log, and Audit WordPress Changes” jest oprogramowaniem open source. Poniższe osoby miały wkład w rozwój wtyczki.

Zaangażowani

Wtyczka „Simple History – Track, Log, and Audit WordPress Changes” została przetłumaczona na 16 języków. Podziękuj tłumaczom za ich wkład.

Przetłumacz wtyczkę “Simple History – Track, Log, and Audit WordPress Changes” na swój język.

Interesuje cię rozwój wtyczki?

Przeglądaj kod, sprawdź repozytorium SVN lub czytaj dziennik rozwoju przez RSS.

Rejestr zmian

✨ If you find Simple History useful ✨

Unreleased

  • Fix export regression, causing not all events to be exported.
  • Fix WordPress error notice when exporting event with no user email.
  • Improve usability for Quick View/post revision info by modifying hover styles to not make scrollbar „jump”. #530

5.6.1 (January 2025)

🚀 This release fixes incomplete exports due to an error in pagination logic.
It also improves the post Quick Diff view by preventing scrollbar jumping on hover states.
A small but very nice improvement! See the difference in the release post.

Fixed

  • Incomplete exports due to error in pagination logic.
  • PHP notice when exporting events with missing user email data.

Improved

  • Enhance post Quick Diff view by preventing scrollbar jumping on hover states. #530

5.6.0 (January 2025)

🔝 This version adds an option to the settings page to control the location of the menu page (at top or bottom).
🫣 It also adds support for Stealth Mode: When enabled, Simple History will be hidden from places like the dashboard, the admin menu, the admin bar, and the plugin list.
👉 Read the release post for more details and examples how to use this feature.

Added

  • Add support for Stealth Mode. When enabled (programmatically using a constant or filters) Simple History will be hidden from places like the dashboard, the admin menu, the admin bar, and the plugin list. #401
  • Add option to set menu page location to settings page. #525
  • Add WP-CLI command simple-history stealth-mode status to get status of Stealh Mode using WP-CLI.
  • Add filter simple_history/show_admin_menu_page to
  • Add filter simple_history/admin_menu_location.
  • Add filters simple_history/show_in_admin_bar and simple_history/show_on_dashboard, that work the same way as simple_history_show_in_admin_bar and simple_history_show_dashboard_widget, but with correct naming convention.

Improved

  • Decrease the icon size in the admin bar and main menu, to match the size of other icons. Props @hjalle.

Fixed

  • Fix for simple_history/show_action_link when being used and returning false then the other action links was not shown.

5.5.1 (January 2025)

  • Fix the redirect from old settings page to new settings page and from old event log page to new event log page not always working when there was for example a WordPress update notice.

5.5.0 (January 2025)

Simple History 5.5.0 contains an improved event log menu location, and more 💥.
Read the release post for more details.

Added

  • Added Simple History to the top level of the admin bar for improved accessibility and visibility. Previously, the plugin was located in the dashboard menu, the settings menu, and contained tools like export and debug scattered across sub-tabs. This change centralizes these tools, making them easier to find and use.
  • Introduced a link to the settings page for users with the Premium add-on, shown in the „events cleared” text. #486
  • Added slotfill SimpleHistorySlotEventActionsMenu to enable future extensions and customizations. #499

Deprecated

  • Deprecated the filter simple_history/admin_location since the event log page now includes sub-pages and cannot be moved.

Changed

  • Updated icons next to menu titles to improve visual clarity and consistency. #517

Fixed

  • Resolved an issue where premium info was displayed below the „clear log” button even when the Premium add-on was installed.
  • Various internal code enhancements and optimizations.

5.4.4 (January 2025)

First release of 2025! 🎉

  • Don’t output CSS and JS for Admin Bar Quick View if admin bar is not visible. #510
  • Only load events from the last 7 days in the Admin Bar Quick View.
  • Remove some unused CSS. #505
  • 🎨 Fresh new logo for the plugin.
  • Style some admin boxes to match new design.
  • Misc other internal improvements.

Changelog for previous versions.