Faultline – Error Log Assistant

Activate Faultline and go to Tools > Faultline. If logging is off, Setup turns it on for you. The Log tab then shows every entry with its severity, the plugin or theme that caused it, and a link to the source code.

Each entry on the Log tab has a "Caused by" label naming the plugin or theme, with a link to that plugin's WordPress.org support forum. "Draft forum post" writes a support request with the error and your site details filled in.

Use Setup. Three settings have to be right together: WP_DEBUG, WP_DEBUG_LOG and WP_DEBUG_DISPLAY. Get one wrong and either nothing is logged or PHP errors are shown to your visitors. Faultline checks all three and can write the correct lines to wp-config.php for you, with a backup first, or give you the lines to paste in yourself.

Under Settings, tick the types to suppress: notices, deprecation warnings, coding-standard suggestions and, if you choose, warnings. Suppressed messages are never written, so there is nothing to clean up.

It may be. debug.log usually sits in a folder your web server serves, and it contains server paths and stack traces. Faultline requests your log over the web the way a stranger would and tells you whether it could be read. Setup runs this check at the end, and you can repeat it on the Status tab. If the log can be read, a warning shows on every admin screen until it is fixed. There are two fixes: move the log to a private file name that bots cannot guess (one click, works on any server, keeps every entry), or add a blocking rule for Apache, LiteSpeed, nginx or IIS. On nginx only your host can usually add the rule, so Faultline writes the message to send them.

No. Setup looks for the PHP error logs your site was writing before, such as the error_log files hosting control panels create, and offers to copy their recent entries into the new log. The original files are only read, never edited, moved or deleted. Automatic cleanup also waits until you finish or skip Setup.

It can. Faultline shows every log entry with its severity, the plugin or theme that caused it and the source code, alerts you to fatal errors, and keeps routine notices out of debug.log.

Faultline is built for acting on errors, not only reading them. It names the plugin or theme behind each error, opens the line of code that failed, drafts a support request, and links to AI help with private details removed. It can also stop routine notices and deprecation warnings being written in the first place. All of this is free.

No. Faultline only ever keeps messages out of the log. It never changes PHP's error reporting level and never turns on WP_DEBUG_DISPLAY, the setting that prints errors on screen. Setup sets WP_DEBUG_DISPLAY to false.

Not completely, but close. Turn on the early loader under Settings and Faultline starts before all of your regular plugins. The early loader is one small file in your must-use plugins folder (wp-content/mu-plugins). It is only added when you click the button, and it does nothing unless Faultline is active. Faultline still cannot start before WordPress itself, or before a must-use plugin whose file name sorts earlier. The Status tab shows what is in effect. If your host does not let WordPress write to that folder, Settings shows which file to copy there yourself. It also offers "Load Faultline first", which moves Faultline to the front of your plugin list instead.

When you deactivate, Faultline asks whether to undo its wp-config.php changes first, and removes its early loader file if you turned that on. Deleting the plugin removes its settings and stored data. It does not touch wp-config.php or your log file.

Yes, site by site. On a network, Faultline does not add the early loader file for you, because one file affects every site. Settings shows the file to copy yourself. When the plugin is network-activated, the "Load Faultline first" setting does nothing, because WordPress stores network-wide plugins differently.

It hides the types of message you choose, and nothing else. Fatal errors, parse errors and uncaught exceptions are always logged. Warnings are logged unless you turn them off. Notices, deprecation warnings and coding-standard suggestions are suppressed by default because they are rarely something you can act on in someone else's plugin.