Enjoy upto
80% OFF

WordPress Troubleshooting Errors Guide to Beginner’s

WordPress Troubleshooting Errors Guide to Beginner’s

Broken code is probably the most common reason why WordPress sites won’t load. Unfinished or incomplete auto-updates for your WP site or WP plugins. Incompatible plugins. Poor plugin or theme coding. Do you want to troubleshoot these WordPress errors on your own? Most of these errors can be solved by following easy troubleshooting steps. In this beginner’s guide, we will show you how to troubleshoot WordPress errors one step at a time.

1. Create a Complete Backup of Your WordPress Site

The first thing you should do is to create a complete backup of your WordPress site. If you were already using a WordPress backup plugin, then make sure that you have a recent backup safely stored somewhere.

If you were not using a backup plugin, then you should start using one immediately. However, in case you don’t have access to the admin area of your WordPress site, then you will need to manually backup your database and files.

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.

2. 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 implement their own caching to improve performance.

You need to clear your WordPress cache to make sure that your website is not serving a cached version.

3. Clear Browser Cache

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

You may need to clear your browser cache to ensure that you are seeing the latest version of a page. We have a detailed guide that will show you how to clear browser cache in all major browsers.

4. Deactivate All Plugins Installed on Your Website

Most of the times errors are caused by plugins conflicting with each other, your theme, or the WordPress core. Deactivating all WordPress plugins on your site will most likely solve the problem. You can then find out which plugin was causing the issue by activating plugins one by one on your site.

If you have access to the admin area of your WordPress site, then simply head over to the plugins page.

First, you need to select all plugins, and then select ‘Deactivate’ from ‘Bulk Actions’ drop down menu. Click on the Apply button to deactivate all selected plugins.

If you do not have access to the admin area, then you will need to use FTP or phpMyAdmin to deactivate all plugins.

Simply connect to your website using an FTP client. If you haven’t used FTP before, then you may want to see our how to use FTP to upload files to WordPress.

Navigate to the wp-content folder and rename plugins folder to “plugin.deactivate”.

5. Switch to a Default WordPress Theme

Sometimes your WordPress theme can cause issues on your site. You can easily find out if your theme is causing an issue by switching to a default WordPress theme like Twenty Nineteen or Twenty Twenty.

Head over to Appearance » Themes page and then click on the Activate button next to a default theme.

However, if you don’t have access to the admin area of your WordPress site, then you will need to use FTP to switch theme.

Connect to your website using an FTP client and then navigate to /wp-content/themes/ folder. Download your current active theme as a backup to your Desktop.

After that, you need to delete all themes except a default WordPress theme like TwentySixteen. Since your active theme will no longer be available, WordPress will now automatically switch to using the default theme available.

If your theme was causing the issue, then you should be able to log in to your WordPress site now.

6. Backup and Delete .htaccess File

A corrupt .htaccess file is often the cause of the internal server error.

First, you need to connect to your website using an FTP client. The .htaccess file is located in your site’s root directory.

Since it is a hidden file, you may need to force your FTP client to show hidden files. See our article on why you can’t find .htaccess file on your WordPress site

You need to download the .htaccess file to your computer as a backup, and then delete it from your web server.

You can now try to login to your WordPress site and go to Settings » Permalinks page. Click on the Save Changes button to refresh your permalinks and to regenerate a new .htaccess file for your site.

WordPress uses SEO friendly URL structure or Permalinks. Sometimes the permalink structure is not updated or configured properly, which may result in unexpected 404 errors on your site.

You can easily refresh permalinks without changing anything on your WordPress site. Visit Settings » Permalinks page and click on ‘Save Changes’ button without changing anything.

8. Fix WordPress Site URL

Having incorrect settings for WordPress URL and Site URL options can also cause redirect issues404 errors, and some other common issues.

WordPress URL and Site URL options can be changed from admin area by visiting Settings » General page.

Make sure that both URLs are exactly the same.

If you do not have access to the admin area of your WordPress site, then you can change these URLs using FTP. There are two ways to do that using FTP:

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

Once connected to your website using an FTP client, locate wp-config.php file. Now you need to edit this file in a text editor like Notepad.

Go to the line that says /* That's all, stop editing! Happy blogging. */, and just before it, add this code:


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

Update URLs Using functions.php File

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

Open your FTP client and navigate to /wp-content/themes/ folder. Open your current active theme’s folder and locate functions.php file inside it. Now you will need to edit the functions.php file in a text editor like Notepad.

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

update_option( 'siteurl', 'http://example.com' );
update_option( 'home', 'http://example.com' );

Don’t forget to change WordPress URLs from the settings page after you login to your site. Once you have added them on the settings page, you need to delete these lines from your theme’s functions file.

9. Check Reading Settings

If your newly created WordPress site is not indexed by search engines, then this is the first thing that you should do.

Login to your WordPress site and go to Settings » Reading page. Scroll down to the bottom of the page and make sure that the box next to ‘Search Engine Visibility’ is unchecked.

This option allows you to discourage search engines from showing your website in search. It is used by webmasters when they are working on a website that is not ready to be live. Sometimes you can accidentally check this setting and forget about it.

Make sure that this option is unchecked when your website is ready to go live.

10. Troubleshooting Email Issues

Many WordPress hosting providers do not have mail settings properly configured. This stops you and your users to receive emails from WordPress.

If you are using a contact form plugin, then you will not be able to receive those emails as well. You will also not receive any WordPress notifications.

See our complete step-by-step instructions in our article on how to fix WordPress not sending email issue.

11. Scanning for Malware and Backdoors

If you suspect that your WordPress site is affected by malware, then you should scan your website with Sucuri. It is the best website security monitoring service for WordPress site owners.

See our case study of how Sucuri helped us block 450,000 WordPress attacks in 3 months.

12. How to fix error: Incompatible Archive

When attempting to upload a theme or plugin to WordPress (specifically WordPress version 6.4.3), you may run into this error: Incompatible Archive.

More information about the bug in incompatible archive bug in WordPress 6.4.3

This happened because of a bug introduced in WordPress 6.4.3, specifically this changeset.

There is a bug fix and core trac ticket to follow about this issue here.


Here is the solution. Add the below hook on function.php in the active theme.

add_filter( 'unzip_file_use_ziparchive', '__return_false' );

Getting Better Support

After following the above-mentioned troubleshooting steps, you would be able to fix many of the most common WordPress errors. However, if the problem persists, then you can seek further support.

WordPress is community software, so you can get help from the community by posting in WordPress support forums. Here is how to write a better support request:

  • Be polite and nice. No matter how upset or frustrated you are, do not use harsh language.
  • Mention your problem briefly.
  • Describe troubleshooting steps you have taken so far.
  • Uplaod screenshots on a cloud image sharing service, and then add the links in your support thread.

You may connect with us on Facebook and X. Also, check out our YouTube channel to view videos.

Golam Mostafa
Written by

Golam Mostafa

I'm a senior plugin developer for WordPress. I have four years of experience working as a software engineer for ADB Bank, and in 2018, I started developing plugins and founded ThemeDev.

Table of Content

Table of Contents

LTD Deals: 10+ Pro Plugins

Limited Time Offer
LTD Deals: 10+ Pro Plugins

Offer ends soon! Don't let it get away this time!


Trusted by 25,099+ Customers

30 days Money Back Guarantee