Beginner’s Guide to Troubleshooting WordPress Errors (Step by Step)

WordPress errors can be frustrating, especially if you’re new to website management. But don’t worry; you can fix most issues with our proven, simple steps.

At WPBeginner, we’ve been running websites for over 16 years and have encountered many different errors during that time. We’ve gathered plenty of experience and know what works best to solve these problems.

In this guide, we’ll walk you through troubleshooting common WordPress errors. There is no need for advanced technical expertise. Just follow along, and you’ll have your site running smoothly in no time.

What Are WordPress Errors and Why Should I Care?

WordPress errors are mistakes or problems that happen on your WordPress site. They can show up as messages, broken pages, or things not working right.

Some of the most common WordPress errors include the ‘White Screen of Death,’ internal server errors, and database connection issues.

You should care about these errors because they can mess up your website and make it look unprofessional.

A broken site can turn visitors away, resulting in a high bounce rate.

Additionally, unresolved errors can affect your site’s performance and security. This can lead to slower load times and introduces potential vulnerabilities that hackers can exploit. 

So, fixing WordPress errors quickly is important. It keeps your site running smoothly and ensures your visitors have a good experience.

How to Troubleshoot WordPress Errors

Now that you know what WordPress errors are and why they matter, it’s time to learn how to fix them. Troubleshooting these errors may seem tricky at first, but with the right steps, you’ll be able to handle them with ease. 

Here’s a quick overview of all the steps we will cover in the following sections:

Ready? Let’s get your site back up and running!

1. Research Your Error Message

Often, when you encounter a problem with WordPress, you’ll get an error message in the tab where you’re trying to access your website, such as a 404 error.

To learn more about the ‘page can’t be found’ error in the following image, please see our guide on how to fix WordPress posts returning 404 error.

Other times, you may see an error message inside your WordPress admin area, such as the HTTP error that can appear inside the media library.

Every WordPress error is different. If you have an error message, then it makes sense to look for instructions on how to fix this exact error rather than information on how to troubleshoot WordPress errors in general.

Since you’re on the WPBeginner website, you’re already in the right place to solve all the most common WordPress errors. To start, you can see our guide on the most common WordPress errors and how to solve them.

If your error isn’t on this list, then the next step is to look for articles that mention the error you’re getting.

To do this, simply type or paste your error message into the search bar at the top of the page. For example, searching for ‘Error Establishing a Database Connection’ will bring up a complete guide to fixing the database connection error.

WordPress also comes with a debugging system that can log any error messages shown on your site. You can then read through the log to learn more about the problems you’re having on your WordPress website.

For more information, please see our guide on how to find and access WordPress error logs.

2. Create a Complete Backup of Your WordPress Site

Before anything else, the first thing you should do is create a complete backup of your WordPress site.

Backups allow you to restore your WordPress site easily when something goes wrong. They are your first and most important defense against security threats, hacking, and data loss.

If you are already using a WordPress backup plugin, make sure you have a recent backup saved somewhere safe.

Since backups are so important, we recommend creating more than one copy of your WordPress backups and storing it in cloud storage like Google Drive or Dropbox.

Some WordPress backup plugins let you save your files to multiple locations. For example, Duplicator lets you choose between different online storage services, including Amazon S3, Dropbox, Google Drive, and more.

If you are not using a backup plugin, then you should start using one now. To help you get started, here’s our expert pick of the best WordPress backup plugins.

And if you don’t currently have access to the admin area of your WordPress site, then don’t panic. You can still manually back up your database and files.

3. Clear Browser Cache

A lot of times, your browser may not realize that a WordPress page or post has changed and will load an outdated page from the browser cache. This means you will see an older version of your page or post.

If you’re seeing outdated content, then you may just need to clear your browser cache. This process will vary depending on your web browser. For more details, please see our guide on how to clear browser cache in all major browsers.

4. Clear Your WordPress Cache

If you are using a WordPress caching plugin like WP Rocket, then you may be seeing a cached version of your website.

Some top WordPress hosting companies, like Bluehost and SiteGround, also have their own built-in caching software. This can cause you to see a cached version of your website, even if you haven’t installed a caching plugin.

So, if your site is showing outdated content, you may just need to clear your WordPress cache.

5. Deactivate All Plugins Installed on Your Website

Often, errors are caused by plugins conflicting with each other, your theme, or the WordPress core.

The easiest way to troubleshoot these errors is by deactivating all your WordPress plugins. You can then reactivate these plugins one by one, to see when the error happens again.

If you have access to your WordPress site’s admin area, you can simply go to the Plugins page.

First, select all plugins and then select ‘Deactivate’ from the ‘Bulk Actions’ drop-down menu.

Then, you’ll want to click the ‘Apply’ button to deactivate all selected plugins.

Some errors may stop you from accessing your WordPress admin area. If this is the case then you can deactivate your plugins using FTP.

To start, you’ll need to connect to your WordPress hosting files using an FTP client.

If you haven’t used FTP before, then please see our guide on how to use FTP to upload files to WordPress.

Once you’ve done that, let’s open the wp-content folder in your FTP client.

Here, you’ll see a folder named plugins.

You can now either control-click or right-click this folder and select ‘Rename.’

Once you’ve done that, you’ll want to rename this folder to plugin.deactivate. This will deactivate all of your WordPress plugins.

For more detailed instructions, you can check out our article on how to deactivate all plugins when not able to access wp-admin.

After deactivating your plugins, simply check to see whether the problem is still happening on your website or WordPress blog. If your site is now working perfectly, then you’ll know that the problem is related to a plugin.

You can now simply reactivate your plugins one by one to see when the problem starts happening again.

To do this, you’ll want to go back to Plugins » Installed Plugins. You can now find the plugin that you want to reactivate and click on its ‘Activate’ link.

As soon as the problem reappears, you’ll know which plugin is causing the problem. You can then uninstall this WordPress plugin and find a better plugin alternative.

6. Switch to a Default WordPress Theme

Sometimes, your WordPress theme can cause issues on your site. To find out if your theme is causing the problem, you can try switching to a default WordPress theme like Twenty Twenty-One or Twenty-Twenty Two.

Since these themes are created by the official WordPress team, they’re less likely to cause conflicts or have bugs compared to some other third-party themes.

To switch to a default WordPress theme, go to Appearance » Themes.

You can then hover your mouse over any of the default themes.

Then, just click on the ‘Activate’ button.

If you can’t log into the admin area of your WordPress site, then you can switch to a default theme using FTP.

First, let’s connect to your website using an FTP client. Once you’ve done that, you can head to the /wp-content/themes/ folder.

Inside this folder, you’ll see all the themes installed on your WordPress website.

Before making any changes, it’s a good idea to download a copy of your current active theme. This will make it easier to restore your theme after doing this test.

To download your current active theme, simply find the folder that has this theme’s name. Then either control-click or right-click this folder.

After that, we’re going to select ‘Download.’

Once you’ve downloaded this folder, you can go ahead and delete every theme inside your FTP client except a default WordPress theme like Twenty Twenty-Two.

Since your active theme is no longer available, WordPress will automatically switch to using the default theme.

If this solves the error, then you’ll know that your theme was causing the problem.

And if this is the case, we recommend finding a new theme for your WordPress website. To help you out, we’ve posted our expert pick of the best responsive WordPress themes.

If this doesn’t solve the problem, then you can restore your original theme. The easiest way is using the copy you downloaded to your computer. For more detailed instructions, please see our guide to using FTP to upload files to WordPress.

7. Refresh Permalinks

WordPress uses an SEO-friendly URL structure. However, this permalink structure might not be updated or set up properly, which may result in unexpected 404 errors on your site.

If you’re getting 404 errors, then you can try regenerating your links, which will rebuild and repair your permalink structure. You can do this with the click of a button and without changing anything on your WordPress website.

To regenerate your permalinks, you’ll want to go to Settings » Permalinks.

Now, simply scroll to the very bottom of this page and click on ‘Save Changes.’

After a few moments, you should see a message confirming that WordPress has updated your permalink structure.

You might want to read our complete guide on how to regenerate your permalinks in WordPress to learn more.

8. Back Up and Delete .htaccess File

Are you getting an internal server error? A corrupt .htaccess file might be to blame.

The easiest way to fix your .htaccess file is by deleting it. Once done, WordPress will then create a new .htaccess file automatically.

To delete your current .htaccess file, you’ll want to connect to your site using an FTP client. You can then find the .htaccess file in your site’s root directory.

To get to this root directory, simply open the folder that shows your website’s name.

Then go ahead and open the public_html folder.

You should now see your .htaccess file inside this folder.

If you don’t see .htaccess, then your FTP client may be set to hide sensitive files. For more information, feel free to check out our article on why you can’t find the .htaccess file on your WordPress site.

Before doing anything, it’s a good idea to create a copy of your current .htaccess file. So, if anything goes wrong, you can simply restore your original file.

To download your .htaccess file, give it a click and then select ‘Download.’

Once you’ve done that, you can go ahead and delete the original .htaccess file in your FTP window. After that, simply navigate to Settings » Permalinks in your WordPress admin area.

Finally, go ahead and click the ‘Save Changes’ button. WordPress will now create a new .htaccess file for your website.

9. Fix WordPress Site URL

If you have the wrong settings for your ‘WordPress Address’ and ‘Site Address’ options, then it can cause redirect issues, 404 errors, and other common problems.

To take a look at your URL settings, let’s take a look at Settings » General.

On this page, find the ‘WordPress Address (URL)’ and ‘Site Address (URL)’ fields. You need to make sure both of these URLs are exactly the same.

If you can’t access the admin area of your WordPress site, then you can change these URLs using FTP.

After connecting to your site using an FTP client, there are two ways to access these URLs.

Update WordPress URL and Site URL Settings in wp-config.php File

With this method, you’ll add some code to your site’s wp-config.php file.

You’ll find this file in the root folder of your website along with other folders, like wp-content.

Once you’ve found this file, give it a click and then select ‘View/Edit.’

This will open the file in your computer’s default text editor, such as Notepad.

In this file, you’ll want to find the line that says:

/* That's all, stop editing! Happy blogging. */

Just before this line, let’s add the following code:

Don’t forget to replace example.com with your own domain name. You can then save your changes and upload the file back to your server.

Update URLs Using functions.php File

You can also update these URLs using your theme’s functions.php file.

In your FTP client, you’ll want to go to the wp-content/themes/ folder. Then, let’s open the folder for your current active theme and find its functions.php file.

Next, you just need to click on the functions.php file and select ‘View/Edit.’ This will open the functions.php file in your computer’s default text editor.

Simply add the following lines at the bottom of the functions file:

You should now be able to access your WordPress admin area.

Once you’re logged in, let’s head over to Settings » General. You should now be able to change your ‘WordPress Address (URL)’ and ‘Site Address (URL)’ following the same process described above.

Once you’ve done that, you just need to delete the code that you added to your functions.php file. To do this, simply open the functions.php file following the process described above, and then delete the code.

10. Check Reading Settings

If you follow the WordPress SEO best practices, then search engines like Google should find your website automatically.

However, sometimes, a newly created WordPress website won’t show up in the search engine results. This may be because your site is hidden from the search engines.

To check your site’s settings, let’s go to Settings » Reading.

From here, you’ll want to scroll down to the bottom of the page and make sure that the box next to ‘Search Engine Visibility’ is unchecked.

This option discourages search engines from indexing your site.

Website owners often use this setting when they’re still working on their site and don’t want their content to show up in search results.

However, you might accidentally check this setting and forget about it.

If you want your site to appear in search results, then make sure this option is unchecked and then click on ‘Save Changes.’

And if you’re still working on your site, then you may want to create a coming soon page. A beautifully-designed coming soon page will create a buzz around your website and can even act as a lead generation tool.

For step-by-step instructions, you can refer to our guide on how to create beautiful coming soon pages in WordPress.

11. Troubleshooting Email Issues

Some WordPress hosting providers do not properly configure their mail settings. This can stop you and your visitors from receiving emails sent by WordPress.

If you are using a contact form plugin then you won’t get an email when visitors complete your form. You will also not get any WordPress notifications including messages about serious security threats or suspicious activity.

The best way to fix this problem is by using an SMTP service provider. For more details, you can see our guide on how to fix WordPress not sending email issue.

12. Scanning for Malware and Backdoors

Many new WordPress website owners don’t install a security scanner right away, which can let malware go unnoticed. This delay can be risky, as malicious code can remain hidden on your site, causing damage over time without your knowledge.

If you suspect that your WordPress site is infected by malware, then you should scan it with security plugins like Sucuri and MalCare. Even if your site hasn’t been hacked, learning to scan for threats helps protect it against future attacks.

For more information, see our guide on how to scan your WordPress site for potentially malicious code.

Getting Better Support

By following these troubleshooting steps, you can fix most of the common WordPress errors. However, if you’re still having problems with your site, then there are ways to get extra support.

WordPress has a large and helpful community. You can always ask other WordPress users and experts for help by posting in WordPress support forums or in the WPBeginner Facebook group.

When reaching out to the community, it’s important to remember that you’re asking people to take their valuable time and answer your questions for free. With this in mind, it’s important to:

• Be polite and nice. No matter how upset or frustrated you are, do not use harsh or unpleasant language.
• Mention your problem briefly. This will make it easier for people to see what the problem is, and decide whether they can help.
• Describe the troubleshooting steps you have taken so far. This shows that you don’t just want other people to do your work for free. It also means that people won’t waste their time by suggesting things that you’ve already tried.
• Provide context. You can upload screenshots on a cloud image-sharing service and then add the links in your support thread. This can provide a deeper insight into your problem.

For more on this topic, take a look at our guide on how to properly ask for WordPress support and get it.

You can also hire a WordPress support agency to troubleshoot and fix WordPress errors for you.

At WPBeginner Pro Services, we offer affordable Emergency WordPress Support to quickly resolve any WordPress errors you have, including plugin and theme errors, image issues, broken links, 404 errors, comment spam, and more.

Simply choose the service that you need from our WordPress support catalog and our experts will get to work on troubleshooting and fixing the problem.

We hope this article helped you learn how to troubleshoot WordPress errors. Next, you may want to check out our ultimate WordPress security guide or how to recover a lost password in WordPress.

If you liked this article, then please subscribe to our YouTube Channel for WordPress video tutorials. You can also find us on Twitter and Facebook.