Skip to main content

WordPress Troubleshooting

Updated today

WordPress sites can sometimes encounter errors. Oftentimes the problem is a small one, but it can have a big impact. What's more, it take a long time to figure out what is the cause behind the error. In this article, you'll find ways and tools to help you troubleshoot your site.

Tips for Troubleshooting

  • The log files of a site record nearly all events related to its operation. The first place to check is the PHP error log in the WordPress admin, under Tools > Logs > php-error.log, or on the server in /data/log/php-error.log. If you find references in the log to a specific plugin, for example, temporarily disable the plugin and check if the problem is fixed.

  • Caches speed up the site, but sometimes they can be the cause of undesired outcomes. Purge caches in the WordPress admin, or from the command line with the wp-purge-cache command.

  • Try the default theme that comes with WordPress, any one of the Twenty themes. If the problem is resolved, take a closer look at the main theme and its files.

  • Disable plugins one by one. If the problem was resolved for a particular plugin, take a closer look at its files. If you can't disable plugins on a live site, you may attempt to do so in a staging environment (shadow).

  • Install an older version of the theme or plugin. Sometimes broken code is introduced into the site with the install of a plugin, and an older version is a viable alternative before a patch is released.

  • Premium (paid) themes and plugins: if you encounter problems, you should contact the developers of the theme or plugin by contacting their customer service, or taking a look at the documentation and support forums to find out if other users are experiencing the same problem.

Problems Persist, What Next?

If this list did not help you with your problem, please contact our customer support via email ([email protected]). Please gather as much information as possible about the problem so that we can resolve the issue quickly and efficiently. The following things will help us in providing assistance:

  • Knowing when the problem started

  • Steps on how the error occurs, i.e. how the problem can be repeated

  • Whether the problem started after a specific action, such as an update

  • If possible, include screenshots and any error messages in your email


​

Did this answer your question?