How to Use WordPress Log Files to Improve Your Website

Last Updated on January 17, 2023 by 6 Comments

Editorial Note: We may earn a commission when you visit links on our website.
How to Use WordPress Log Files to Improve Your Website
Blog / WordPress / How to Use WordPress Log Files to Improve Your Website
Play Button

WordPress log files are one of the most important aspects of the entire WP ecosystem that you may have never heard of. Or at least, may have never thought of. Log files are essentially records of everything that your website and server has done over its life (or a specific time frame). Unfortunately, many people see log files as being hard to understand and use. We want to break through that misconception and show you how to use WordPress log files and what that knowledge can do to improve your website.

Subscribe To Our Youtube Channel

What Can You Do with WordPress Log Files?

The use of WordPress log files differs depending on your role. A user will find different things useful than an admin would than a developer would and so on. But there are a number of things that these very same log files do, and many of the purposes can overlap.

  • finding errors
  • aid troubleshooting
  • auditing security
  • assessing accessibility standards
  • monitoring user experience and customer journey
  • track user activity
  • check plugin performance
  • explore themes

And a lot more. Plus, there are a lot of different kind of log files. Some are specific to WordPress itself, while others may be generated by individual plugins. Let’s look at some of them in particular to see what you can expect.

WordPress Debug Log Files

Strangely enough, the default WordPress log file itself is disabled for new WP installations. You have to go into the wp-config.php file and manually enable it. The debug logs are disabled by default because logging everything that your WP installation does takes some of your server resources. Instead of running the site, it’s logging how it runs the site.

We recommend that you enable logging only for a short period as issues arise to fix them. Unless you’re working in a development environment, of course.

Now, you can enable logs in multiple ways. Via FTP using a program like FileZilla and editing the file in a code editor. By cPanel, or even via a plugin such as WP File Manager. Regardless, the process is simple. You are going to find the wp-config.php file in your installation’s root directory and add two lines of code to it.

  • define( ‘WP_DEBUG’, true );
  • define( ‘WP_DEBUG_LOG’, true );

Step 1: Finding wp-config.php

Wherever your root directory is, connect there. Most likely it will be under /public_html/ (the .com part may or may not be there).

WordPress Log Files

Step 2: Editing wp-config.php

Once there, open it up in your editor of choice. Sublime Text, VS Code, and Atom are all popular choices. Scroll until you find the line that reads /* That’s all, stop editing! Happy blogging. */ Once there,paste the two lines of code above directly above it. You might even have one marked false already in the file.

WordPress Log Files

The top line enables debugging to occur, while the second generates the log file itself. In this format, the snippet saves the WordPress log file to wp-content/debug.log, but you can replace true with a relative path in single quotes to specify a different place. For example, define( ‘WP_DEBUG_LOG’, ‘/tmp/wp-errors.log’ ); as specified in the WordPress Codex entry on debug logs.

Step 3: Finding, Reading, and Understanding the Log File

Be aware, your log file might not appear immediately. It is not a real-time log of the server’s activities, but a log of the errors that occur within it. Hence why we recommended earlier that you only enable it when something is going wrong. So if the debug.log file doesn’t exist yet, give it time. Something will break, eventually.

WordPress Plugin Page

When you finally get the debug.log file, you can open it either in the file manager or in the code editor of your choice. But you will see something similar to this.

WordPress Support Forums

For a typical WordPress user, this looks like gobbledygook. For a developer, though, they would see the PHP issues in a couple of plugins being unable to perform certain tasks.

Step 4: Get Help

As we said above, most WP users would have no idea what to do with these errors. However, when your site isn’t performing optimally, you need these thing fixed. That’s when you have to find someone to help you.

You have a few choices in this particular path, the most obvious of which is to download the entire debug.log file and send it via Slack or email to your systems administrator. Most of the time, this is the best choice. Even if you’re a dev and have this log, you’ll probably be sending it up the chain (or maybe down it, if you’re a senior dev and delegating tasks).

But if you’re not part of a team, you will also likely need to take the file and send it somewhere. But where? Stack Overflow. Or maybe even more specifically, WordPress Stack Exchange (the subforum from SO based around WP). If you can’t get an answer on Stack Overflow or Stack Exchange about your tech problem, you should go buy a lottery ticket. Because those are some crazy odds.

Additionally, you could send the debug logs to the developers of the plugin directly, or even post on the official WordPress help forums over at While the issues may be with individual plugins, the logs are from WP and folks have likely run into these particular issues before.

On top of that, there are plugin support pages on each plugin’s repo page.

WordPress Log Files

These take you to the direct support forum on for that specific plugin.

WordPress Log Files

Using these forums can get some individualized help for your problems.

Wrapping Up

As you can see, WordPress error logs are incredibly dense. They can be intimidating, and even getting them set up (outside of using a plugin) can be scary for some folks. But if you keep the debugging limited to either a development environment or shut it off after grabbing the logs on a public server, they are a fantastic troubleshooting tool to see what’s going wrong under the hood of your site. So the next time your users have an issue, or even your staff has an issue with the backend of the site not performing as expected, WordPress log files can be a fantastic line of defense.

What kind of situations have monitoring WordPress log files have you been able to fix or prevent?

Article featured image by fatmawati achmad zaenuri /


Want To Build Better WordPress Websites? Start Here! 👇

Take the first step towards a better website.

Get Started
Premade Layouts

Check Out These Related Posts

Easiest WordPress Themes for Beginners in 2024 (Compared)

Easiest WordPress Themes for Beginners in 2024 (Compared)

Posted on May 7, 2024 in WordPress

Choosing a WordPress theme can be overwhelming, especially for a beginner. No need to worry, though. We’ve combed through hundreds of popular WordPress themes to showcase free and premium options suited to those new to WordPress. Whether you need a free or a premium option, the products on...

View Full Post
MonsterInsights Review 2024: Worth It for Site Analytics?

MonsterInsights Review 2024: Worth It for Site Analytics?

Updated on April 16, 2024 in WordPress

Do you want to integrate Google Analytics (GA) on your WordPress website easily? Look no further than MonsterInsights. It offers invaluable insights into your site’s traffic, user behavior, and content engagement. As the leading Google Analytics plugin for WordPress, MonsterInsights empowers...

View Full Post


  1. Thanks. This helped me solve the bug on my website. I know if I have any problem on my site, I can always rely on you. Thank you for posting such a useful information.

  2. Exactly what I have looking for. Thank you much!

  3. Hi Keeton,

    Nice article you write, but I have a confusion. While the description of logs makes their usefulness to developers clear, do they have any value for WordPress site admins?

  4. Hi but if you do that and go into Divi > Support you get a red dot flag:
    1 – We recommend 0 for the best experience.

    So how to log errors but not get the flag?

  5. I really appreciate this, i’ve been facing fatal error issues whenever i am trying to save anything on my wordpress site not until i debug it and see that it is php memory limit issues that is affecting it, you have really saved me from a lot of stress and a bad nightmare.

    Thanks to you B.J.

  6. It would be nice if the Divi support page would have an option to enable debug logging. Just so support doesn’t have to come back at you to ask you to enable it. It should be automatically disabled and the log file deleted as soon as the support token expires.

Leave A Reply

Comments are reviewed and must adhere to our comments policy.

Get Started With Divi