The Complete Guide to Troubleshoot and Fix the Most Common WordPress Errors

WordPress errors on your site are serious issues. While some may cause only minor inconveniences, others can result in major problems including Downtime, failed updates and installations, and missing resources can prevent visitors from accessing or using your site. This hurts your credibility and potentially affects your income.

It’d be almost impossible to know every potential WordPress error inside and out. However, understanding some of the most common WordPress issues users experience can help you prepare and troubleshoot WordPress problems when they pop up.

This post covers the most frequently-experienced WordPress errors and how to clear up each of them, so you can get your website up and running again quickly.


Further reading:

WordPress Performance: How to Find a Slow Plugin

WordPress Maintenance Tasks You Need to Perform Regularly

Top Three Best Safeguards for Every WordPress Website

The Most Common Reasons Why Your Website can be penalized by Google

Most Common WordPress Errors and How to Fix Them


In order to cover so many different issues in a single post, we've organized them roughly according to type. Below you’ll find a general description of the various components of your WordPress site and the problems they might experience, followed by the specific errors and their solutions.

  1. 400 Errors
  2. 500 Errors
  3. Server-Related Errors
  4. Security-Related Errors
  5. WordPress Media Errors
  6. Database Errors
  7. PHP Errors
  8. WordPress File Errors
  9. Browser Errors
  10. Troubleshooting Miscellaneous WordPress Errors


400 Errors


Errors labeled with a number between 400 and 499 are HTTP client errors. This usually means that something has gone wrong during the communication between the browser your site’s visitor is using and your site’s server.


1. 400 Bad Request


The 400 Bad Request response is a catch-all for when your server experiences a client error, but it doesn’t fall into a specific category. That means this error has several possible causes, including:

  • An incorrectly-typed URL or one that contains disallowed characters.
  • Corrupted browser caches or cookies.
  • Discrepancies between Domain Name System (DNS) data and your local DNS cache.
  • Trying to upload a file that is too large.
  • Some kind of general server error.

Potential solutions include checking the URL for typos, clearing your browser cache and cookies, clearing your DNS cache, and deactivating browser extensions.


Related posts:

Common Errors Bloggers Should Avoid

How website errors affect search engine rankings


2. 403 Forbidden


There are many measures in place to keep your WordPress site safe, including varying levels of ‘permissions’. While this feature can prevent people who shouldn’t have access to your site from gaining entry, it can sometimes cause problems if the permissions are not set properly.

To fix it, you’ll need to reset your file permissions or generate a new .htaccess file. This issue may also be the result of a problem with a plugin, your Content Delivery Network (CDN), or hotlink protection.


3. 404 Not Found


A 404 error occurs when a user attempts to access a web page that doesn’t exist. Instead of finding the resource they were looking for, they’ll see a page similar to this one:

This problem is relatively harmless but nevertheless frustrating for users. To avoid it, make sure to fix broken links on your site periodically and implement redirects if you delete a page or move it to a new URL.


Related reading:

How to Fix Error 404 Not Found on Your WordPress Site

Best Practices for Managing 404 Error Pages


4. 405 Method Not Allowed


The 405 Method Not Allowed error is your server’s way of saying that it has received the browser’s request but rejected it for some reason.

There are several possible ways to resolve this problem, including rolling back recent theme and plugin updates, checking your server’s configuration and error logs, and debugging your application code.


5. 413 Request Entity Too Large


If this error appears in your browser, it means that the server of the site you’re trying to access can’t process the HTTP request you’ve made because it’s too large.

This often occurs if you’re trying to upload a very ‘weighty’ file. You can resolve this problem by increasing your maximum HTTP request size.


6. 429 Too Many Requests


If a user attempts to access a certain resource too many times over a short span of time, they may receive a 429 Too Many Requests error. This is your server’s way of blocking out suspicious behavior.

To help prevent cyberattacks on your login page that may lead to a 429 error, you can change its default URL. Other solutions include testing for theme and plugin conflicts.


500 Errors


Any error on your site that is labeled with a number between 500 and 599 is an indication that your server is incapable of performing a given request for some reason. Here are a few of the most common examples.


7. 500 Internal Server Error


In addition to preventing users from accessing your site, a 500 Internal Server Error can negatively impact your SEO if not resolved quickly:

An Internal Service Error in Google Chrome

Unfortunately, the 500 error has many possible causes and solutions, which can make troubleshooting this issue tricky. You can start by clearing your browser cache and reloading the page. If that doesn’t work, you can dive into more technical debugging methods.


8. 501 Not Implemented


This error means that your server doesn’t have the functionality needed to complete the request made by the user’s browser. It’s likely that the server doesn’t recognize the request method.

As with a 500 Internal Service Error, a 501 error can lower your search engine rankings if you don’t resolve it within a few hours. You can try reloading the page, clearing the browser cache, and disabling any active proxy settings to resolve it.

However, you’ll likely need to contact your host for help.


9. 502 Bad Gateway


In cases where one server is acting as a proxy or ‘gateway’ for another, there’s a chance that users may encounter a 502 Bad Gateway error. This occurs when the proxy receives an invalid response from the inbound server.

A 502 error can impact your SEO, so it’s best to get it cleared up fast. Reloading the page and clearing your browser cache are good places to start. If those solutions don’t work, check for issues with your DNS, try disabling your CDN or firewall, or contact your host for assistance.


10. 503 Service Unavailable


When a 503 Service Unavailable error appears, it means that for some reason your server can’t be reached. Although your website is up, it won’t be accessible to users.

This may be due to routine maintenance, high traffic levels, or a more serious problem with your server. The good news is that a 503 error won’t influence your search engine rankings. It can still be highly annoying to visitors, however. To fix it, you can try:

  • Deactivating your plugins.
  • Switching to a default theme.
  • Disabling your CDN.
  • Limiting the WordPress Heartbeat API.
  • Increasing your server’s resources.
  • Enabling WP_DEBUG.

If none of these solutions work, your best course of action is to get in touch with your host’s support team.


11. 504 Gateway Timeout


Like a 502 error, the 504 Gateway Timeout response is the result of a problem with the communication between an inbound server and a proxy. Essentially, it means that the latter server timed out while waiting for the former to respond to a request.

This type of error can negatively affect your SEO. Possible solutions include reloading the page, disabling any active proxy settings, checking your DNS for issues, and temporarily disabling your CDN.


Server-Related Errors


Your server is responsible for storing all of your WordPress site’s files and communicating with browsers to make your content available to users.

While the 400 and 500 errors already listed involve your server in some way, there are also some more WordPress-specific issues that can be caused by problems with your server.


12. WordPress Memory Limit Error


Your hosting provider allocates a certain amount of server memory to your site. In the event that you reach your server’s memory limit, you may run into issues installing a new plugin or theme, or uploading media files to your site.

Instead of successfully adding your new resource, you’ll see a message that reads: “fatal error: allowed memory size has been exhausted”. If this happens, you can try increasing your PHP memory limit by editing your wp-config.php file.

Alternatively, you could check how much disk space you’re using and consider upgrading to a new hosting plan that offers more space for your growing WordPress site.


13. Uploaded File Exceeds the upload_max_filesize Directive in php.ini


On a similar note, your host also sets a limit on the maximum size for individual files that you can upload to your server. You can see this limit by navigating to Media > Add New in your WordPress dashboard and looking for the Maximum upload file size (the default upload size at Kinsta is 128 MB):

The maximum upload file size listed in the WordPress Media Uploader

If you need to upload a file that is larger than the specified maximum size, you can change the limit by editing your php.ini file. Alternatively, you can contact your hosting provider to discuss the issue with them.

This is far simpler and less risky than trying to change it yourself and shouldn’t be an issue for your host’s support team.


14. Fatal Error: Maximum Execution Time Exceeded


Servers have time limits on how long scripts can run (usually 30 seconds, at Todhost the default maximum execution time is 300 seconds). In the event that a PHP script on your WordPress site takes longer than the allotted time limit, you’ll likely see the message: “fatal error: maximum execution time exceeded”.

You can resolve this issue by increasing your site’s execution time limit. To do so, you’ll need to find the script that is running too long,  which is likely part of a plugin or theme, and remove it.


15. Upload: Failed to Write File to Disk


Adding images to your posts and pages can make them more useful, interesting, and drive additional organic traffic. However, you’ll have a difficult time doing this if you see a message like “Upload: Failed to write file to disk” whenever you try to add media files to your site.

This error is often due to incorrect file permissions. You can fix this problem by changing your file permissions via File Transfer Protocol (FTP).

However, it can also be an issue with your server. When you upload files to WordPress, they are first saved to a temporary folder on your server. Then, they are moved to the appropriate WordPress directory. If changing your file permissions doesn’t fix this error, contact your host and ask them to empty your temporary files directory, as it may be full and prevent uploads.


16. Secure Connection Error


When you update your WordPress installation’s core files, your site has to connect to Sometimes, due to your server’s configuration, this isn’t possible. The result is a warning in your WordPress dashboard.

As this is a problem directly related to your server, you’ll likely need to contact your host in order to resolve it. Your server may be under a DDoS attack, in which case the error should resolve on its own shortly. Alternatively, you can try fixing the problem yourself by pointing your server towards through Secure Shell Protocol (SSH).


Security-Related Errors

Implementing WordPress security best practices on your site is wise. Cyberattacks could cause serious damage that requires a lot of money to fix. Unfortunately, sometimes the measures you put in place to protect your site can lead to errors.


17. Cloudflare Error 521


Although this is a 500 error like the ones we described in the previous section, it’s specific to Cloudflare. This popular platform is used as a CDN, and for protection against DDoS and other attacks.

Seeing a 521 error on your site means that Cloudflare can’t connect to your server. Either it’s down or is blocking the service for some reason. Generally speaking, checking to make sure your server is up and that its firewall has all of Cloudflare’s IP ranges whitelisted and will let you know what’s causing the problem. You can then take steps to work with your host and resolve it.


18. “Sorry, This File Type Is Not Permitted for Security Reasons”


As a security measure, WordPress has a standard list of permitted file types. This prevents malicious parties from adding executable files to your site that could compromise users’ sensitive information.

If a user tries to upload a file type that is not on that list, they’ll see a message reading: “Sorry, this file type is not permitted for security reasons”:

The “Sorry, this file type is not permitted for security reasons” message

You can enable uploads of file types not allowed in WordPress’ default settings by editing your wp-config.php file.

The WP Extra File Types plugin can also be used as an alternative solution.


19. “Sorry, You Are Not Allowed to Access This Page”


We briefly touched upon file permissions earlier in this post, but to recap, they determine who can edit which files on your WordPress site. This keeps your website safe from hackers who might want to insert malicious code.

However, if your permissions settings are incorrect, they could inadvertently block you or well-meaning users from accessing your site.

This can result in an error that reads: “Sorry, you are not allowed to access this page”.

The “Sorry, you are not allowed to access this page” error message

There are many possible solutions to this issue. You may want to try:

  • Resetting your file permissions via Secure File Transfer Protocol (SFTP).
  • Checking to make sure your account is assigned the correct user role via phpMyAdmin.
  • Ensuring that your database prefix is correct.
  • Troubleshooting for plugin and theme conflicts.

In the worst case scenario, you can also restore a backup of your site or reset WordPress.


20. “Installation Failed: Could Not Create Directory”


Whenever you install a plugin or theme on your WordPress site, its files are added to your server. If during an installation or update you receive a message that says “Installation failed: Could not create directory”, it means that for some reason, WordPress was unable to add the necessary files to your server.

The same applies to plugin and theme updates. This is another file permissions-related error.

To fix it, make sure you’re allowed to Write in your wp-admin, wp-content, and wp-includes directories via FTP.


21. Incorrect File Permissions


In addition to denying you access to certain areas of your site, as in the case of the “Sorry, you are not allowed to access this page” error, incorrect file permissions can prevent you from:

  • Updating or installing plugins and themes.
  • Publishing or updating posts and pages.
  • Uploading images.

On the other hand, if your file permissions aren’t too strong, you leave your website vulnerable and run the risk of hackers gaining access to your files. There they can delete content, steal data, or add their own malicious code.

If you’re running into one of the above issues, or suspect that you’ve been hacked, you may want to verify your file permissions via SFTP:

The file permissions window in FileZilla

The default numeric values for WordPress are 755 for folders and 644 for files.




Secure Sockets Layer (SSL) certificates are a security measure used to encrypt data. This prevents hackers from stealing sensitive data such as credit card information as it’s transferred between servers.

If you’ve recently switched hosting providers or installed a new SSL certificate on your site, you may see an ERR_SSL_PROTOCOL_ERROR in your browser. This means that, for some reason, your server was unable to establish a secure connection.

There are several steps you can take to resolve this issue, including updating your browser and operating system, verifying your SSL certificate, disabling browser extensions, and clearing your browser cache and cookies.




The ERR_SSL_VERSION_OR_CIPHER_MISMATCH error could indicate that your browser or operating system is out of date. It may also result from issues with your SSL certificate, or pop up after you migrate your WordPress site to a new host.

If updating your browser and operating system doesn’t help, check for a name mismatch in your SSL certificate. Alternatively, clearing your computer’s SSL state may resolve the issue, or your SSL certificate may be outdated.


24. Mixed Content Warnings


When you add an SSL certificate to your WordPress site, it will start running HTTPS instead of HTTP. In the event that your website is trying to load both HTTPS and HTTP content or scripts simultaneously, you’ll see a mixed content warning.

This will probably read as some variation of: “This site is not fully secure”. In order to resolve the error, you’ll need to follow a few steps to determine which HTTP resources are loading and remove or replace them with HTTPS resources.


WordPress Media Errors


In WordPress, ‘media’ most often refers to image files. However, it also includes video and audio. While these elements can provide engaging and interesting content for your users, they’re sometimes tricky to incorporate due to various errors that may arise in the process.


25. WordPress HTTP Error (Uploading Image to the Media Library)


While trying to upload a file to the WordPress Media Library, you may have come across a vague ‘HTTP error’. This generally appears as a small popup box on the right side of the image uploader.

There are a few possible causes for this problem, including an expired login session, disallowed characters in the file name, wrong permission, and server-side issues.

First, start by refreshing the page. If that doesn’t work, try resizing or renaming your media file. If not in luck, you should then check your permissions or temporarily deactivate your plugins and theme. In the event that you still can’t complete your upload, you may want to contact your host.


26. The Add Media Button Isn’t Working


In the WordPress Classic Editor, the Add Media button is an important feature:

The Add Media button in the WordPress Classic Editor

This button enables you to quickly upload new media files or select one from your Media Library to add to your post. However, sometimes clicking on the button does nothing or it may be missing from the editor entirely.

If this is the case, the issue is likely due to a plugin or theme conflict. You can resolve it by adding the define(‘CONCATENATE_SCRIPTS’, false) function to your wp-config.php file or by troubleshooting for potential compatibility errors.


27. Broken Media Files


If you open your media library and find that all of your images are gone entirely or have been replaced with placeholders, your files may be ‘broken’:

Broken image files in the Media Library

This can happen for a wide variety of reasons, including:

  • A problem with your server, such as a performance issue.
  • Compatibility errors between your plugins and/or theme.
  • Incorrect file permissions.
  • A hack or other attack.

To fix the issue, you can try resetting the file permissions for your uploads directory to 755. If that doesn’t work, look to see if there may be any plugin conflicts. After that, if your images are still broken, contact your hosting provider to see if the cause is a server issue.


28. “There Has Been an Error Cropping Your Image”


In the WordPress Media Library, you can implement minor edits to the images you’ve uploaded, such as rotations and cropping. While attempting to edit in this way, you may receive the message: “There has been an error cropping your image”.

There are two possible causes for this error. The first is that you’re running on an outdated version of PHP, in which case you can simply upgrade to fix it. On the other hand, your server may be missing the necessary Graphics Draw (GD) package.

If this is the case, you’ll need to follow appropriate steps for installing it based on your setup. In the event that you run into trouble, you should contact your hosting provider for help.


29. Incorrect Facebook Thumbnail


Social sharing can be an efficient method for building your website’s audience. However, sometimes the wrong thumbnail image may be displayed when your posts are shared on Facebook.

This often occurs when multiple images in your post include the Open Graph (OG) tag. Facebook uses this tag to guess which image it’s supposed to use for the thumbnail, but when multiple images include it, the platform gets confused.

One way to fix this issue is by using Yoast SEO’s social sharing features. By setting your Facebook thumbnail via this plugin, you can ensure that the correct image has the OG tag in place.


Database Errors


Your WordPress installation is made up of two key parts: its files and its database. While you’re more likely to interact with the former on a regular basis, your database is also vital to your site’s ability to function properly.

30. Error Establishing a Database Connection


In the event that your website can’t establish a connection with your MySQL database, it won’t be able to retrieve the data necessary to display your content. Instead, you’ll see an error like this one:

The Error Establishing a Database Connection

This will prevent users from viewing the front end of your site, and also locks you out of your WordPress dashboard. The most common cause of this error is that your database credentials are incorrect. You can change them in your wp-config.php file.


31. The WordPress Database Is Corrupt


‘Corruption’ is a general term applied to WordPress databases and files when they’ve become compromised or unusable. This will often result in an Error Establishing a Database Connection.

Ideally, you’ll want to restore a backup of your database to replace the corrupt version. If that’s not possible, you can also fix this error by adding the define(‘WP_ALLOW_REPAIR’, true) function to your wp-config.php file.


PHP Errors


PHP is a coding language that is integral to WordPress. Issues related to its functionality can prevent you from editing your site or result in intrusive messages and notifications.


32. PHP Errors in WordPress


When there is a problem with your WordPress site’s PHP, you’ll see a message or warning at the top of your WordPress dashboard stating what the problem is and which files are affected.

These messages are intended for developers, so they can dig into their sites’ code and revise the issue. If you don’t have experience with PHP, trying to resolve these errors could cause more problems for your site.

In the event that this describes your situation, don’t worry. PHP errors shouldn’t stop your site from running or prevent users from accessing it.

Ideally, you’ll want to contact the developer of any related plugins or themes that might be causing the issue. Otherwise, you can hire a developer to help you fix it.


33. “Missing a Temporary Folder”


Any time you upload a file to your WordPress site, it’s first stored in a temporary folder before being moved to its permanent directory. However, incorrect PHP settings on your server could prevent access to this temporary folder, leading to an error on your WordPress site.

Resolving this problem requires you to access your server via FTP and add the following function to your wp-config.php file:

define(‘WP_TEMP_DIR’, dirname(__file__). ‘/wp-content/temp/’);

Then, you can add a new folder named temp to your wp-content directory.


WordPress File Errors


From your posts and pages to your plugins and themes, your WordPress installation contains hundreds if not thousands of files. Errors related to these key components can result in lost or unavailable content.


34. “Destination Folder Already Exists”


When you install a new theme or plugin on your WordPress site, a folder is created on your server to store its files. If you attempt to install a plugin or theme, and a folder with the same name is already saved on your server, you’ll see an error reading “Destination folder already exists…Plugin installation failed”:

The “Destination folder already exists” error

Your first step when confronted with this issue should be to check to see whether the plugin or theme is already installed.

If not, access your server via FTP and navigate to your wp-content folder. Then, look through your plugins or themes to see if a folder with the same name as the component you’re attempting to install exists. Once you delete that folder, you can try your installation again.


35. The WordPress Theme Stylesheet Is Missing


CSS is a coding language that determines your site’s ‘styling’. This may include colors, fonts, and a variety of other elements that make your website interesting to look at.

When it comes to WordPress themes, all the necessary CSS is contained within a file called a ‘stylesheet’. If your theme’s stylesheet isn’t available, your site won’t be able to load properly, and you’ll see an error:

The “Stylesheet is missing” error in the WordPress themes list

This may also occur during a theme installation:

A failed theme installation due to a missing stylesheet

This could happen because your theme’s stylesheet hasn’t been uploaded to your server, or because it’s named incorrectly and therefore can’t be found. To fix the  problem, access your server via FTP and navigate to your theme’s subdirectory.

Then, look for your theme’s stylesheet. If it’s not there, retrieve it from your theme’s files and upload it to your server. Make sure the file is named style.css and is saved within the correct theme folder.


36. Pluggable.php File Errors


Your WordPress site’s pluggable.php file enables users, plugins, and themes to override core functionalities. If a plugin or theme isn’t coded properly, it may result in a conflict with this file.

The issue will appear as a php error message in your WordPress dashboard that references your pluggable.php file. However, the cause of the problem isn’t usually within pluggable.php itself, it could be your wp-config.php or functions.php for example.

Instead, you’ll need to find the real location of the conflict in the error message. Then, navigate to the relevant file and fix it by removing spaces, empty lines, or something similar.


37. WordPress Files Are Corrupt

Just as your WordPress database can become corrupt, so too can its files. This will make them inaccessible, which is a big problem, especially when it comes to core files.

Corrupt files may be the result of a server failure, incorrect file permissions, or a PHP version error. The simplest fix is to restore a site backup.

Alternatively, you can replace core files by downloading WordPress, deleting the corrupt files via FTP, and then uploading fresh copies from the WordPress .zip file.


Browser Errors


Visitors access your website using browsers of their choosing. This means that various browser errors can keep users from reaching your site. Preventing them will help you avoid missing out on traffic.


38. “Not Secure” Warning in Chrome


When browsing the internet using Google Chrome, you may have noticed that some pages have a ‘Not Secure’ warning next to their URLs:

The browser displays this warning when a website is not using an SSL certificate. If your pages trigger these messages in users’ browsers, it can hurt your site’s credibility, impact your traffic level, SEO, and conversion rates. To prevent this from happening, you can install an SSL certificate.

More recently, Chrome started showing ERR_SSL_OBSOLETE_VERSION warning messages for websites that aren’t using TLS 1.2 or 1.3.


39. “Your Connection Is Not Private” Browser Error


Even worse than the “Not Secure” warning in Chrome is the “Your Connection Is Not Private” page. This error prevents users from easily accessing your site, due to a problem with its SSL certificate (or lack thereof).

If they encounter this page, users may be scared away from your site for fear of their personal information being stolen. You can try to prevent this from happening by ensuring that your SSL certificate is installed properly, but it may also be a client-side issue that your users will have to fix themselves.




A redirect loop, which often displays as “ERR_TOO_MANY_REDIRECTS”, happens when there’s a misconfiguration of redirects on your server.

For instance, this could mean that URL 1 is pointing to URL 2, but URL 2 is pointing back to URL 1, causing an infinite loop. Users can try fixing this error by deleting your site’s cookies and clearing their browser caches. You can also try to determine the nature of the redirect loop, in order to figure out the source of the problem and then resolve it.




Like many browser issues, the ERR_CONNECTION_REFUSED issue usually isn’t caused by something specific to WordPress. However, if users contact you because they can’t access your site due to this message in Chrome, it still helps to be able to tell them how to fix the problem.

The ERR_CONNECTION_REFUSED error occurs because the user’s browser was unable to connect to your site’s server. This could be a server-side problem, in which case you should check to see if your site is down and contact your hosting provider. Alternatively, you can try instructing your users to restart their routers and clear their browser caches.




The ERR_EMPTY_RESPONSE issue occurs when a user’s browser sends a request to your site and your server sends nothing back. The most popular fixes for this issue are to clear your browser cache and reset your network settings.

You may also want to advise users who are experiencing this problem to disable any Chrome extensions they’re using and try temporarily disabling their anti-virus software.




Your DNS is the system that takes your website’s IP address and turns it into a readable domain. If your DNS fails to translate your domain into your site’s IP address correctly, users will see the DNS_PROBE_FINSHED_NXDOMAIN browser error in Chrome.

The first steps to resolve this issue are to release and renew your IP address. If that doesn’t work, you may suggest that users try temporarily disabling their anti-virus software or Virtual Private Networks (VPNs).


Troubleshooting Miscellaneous WordPress Errors


While many WordPress errors can be traced back to a specific cause, some are a little more difficult to diagnose. They may have multiple possible origins or lead back to a minute detail that doesn’t seem significant.

Below are a variety of WordPress problems that don’t fit neatly into the categories we’ve covered so far.


44. The White Screen of Death


One of the most famous WordPress errors is the White Screen of Death (WSoD). It causes your site to display as a blank white page to its users. This issue may also lock you out of your WordPress dashboard. Usually, it is caused by a plugin compatibility issue.

The best course of action for resolving it is to find the plugin that’s causing the conflict and remove it. Other possible causes include syntax errors, reaching your site’s memory limit, and file permissions issues.


45. Locked Out of the WordPress Admin Dashboard


Your WordPress dashboard is highly important for numerous tasks, including fixing many common WordPress errors. However, sometimes the issues you’re experiencing on your site can lock you out of your WordPress dashboard.

There are many possible causes for this problem. If you can, try to determine whether you’re locked out due to a separate problem, and then take steps to resolve the root of the issue. You can also try restoring a backup of your site, or disabling a security plugin via FTP if you believe it’s keeping you from your site’s backend.


46. Can’t Connect via SSH or SFTP


Sometimes, WordPress management or troubleshooting will require that you access your server directly. SFTP enables you to access your files, and SSH permits a wide variety of other remote tasks (here’s a guide on how to get started with SSH).

If you’re attempting to use SFTP or SSH to reach your server but can’t connect, you may need to delete outdated IP addresses from your known_hosts file.


47. SSH Connection Refused


In the event that you’re trying to connect to your server via SSH, and you see a message that reads “Connection refused” in your command line interface, the problem is slightly different:

The Connection refused error message in Terminal

Instead of editing known_hosts, you’ll need to check a few things related to your SSH configuration.

First, make sure that your server has an SSH daemon installed. You should also check your credentials and determine if the port you’re using is open. The issue could also be due to your firewall settings.


48. Briefly Unavailable for Scheduled Maintenance


Whenever you run updates on your WordPress site, it temporarily goes into maintenance mode. During this time, anyone who tries to access your site will see a message that says something like: “Briefly unavailable for scheduled maintenance. Check back in a minute”:

The “Briefly unavailable for scheduled maintenance” message in WordPress

This isn’t truly an error, since it’s supposed to happen, but users may interpret it differently. If they contact you about it but you’re not experiencing trouble on your end, you’ll want to recommend that they reload the page.

If you’re seeing this message while running updates in WordPress, on the other hand, your site may have gotten stuck in maintenance mode.


49. WordPress Stuck in Maintenance Mode


Closing your browser in the middle of an update or running bulk plugin updates can cause your site to get stuck in maintenance mode. In this case, you’ll see the same message that users see on the front end when you run updates.

Fortunately, fixing this problem is quite simple. All you have to do is access your site’s files via FTP, and delete the one named .maintenance:

After that you can check back with your site and all should be well again.


50. Changes Aren’t Visible on Your Live Site


If you’ve put in a lot of hard work to make updates to your site, only to check the frontend and see that none of them are visible, you may be feeling frustrated. The good news is that this problem is usually very simple to fix.

Most often, it’s the result of a caching issue. First, you can try clearing your browser cache. If your changes still aren’t visible and you’re using a caching plugin, check its documentation to learn how to clear the plugin’s cache as well.


51. Missed Schedule


A consistent upload schedule is part of a strong content strategy. WordPress helps with this by enabling you to schedule posts for publication at specific dates and times.

Unfortunately, it doesn’t always work as intended, resulting in missed schedule errors. Generally speaking, the quickest solutions to this problem are either available via plugins, such as Scheduled Post Trigger or WP Scheduled Posts Pro, or by editing cron jobs.


52. Failed Auto-Update


In order to help your site stay on the latest version of WordPress, you may have auto-updates enabled. This can be handy for streamlining this aspect of website maintenance and keeping your site secure, but it also sometimes results in problems.

Auto-updates can sometimes fail, in which case your site may go down and become unavailable to users. The recommended fix is to carry out a manual update instead.


53. WordPress Import Issues


For a variety of reasons, you may find that you need to import content into your WordPress site. This is a fairly common practice among developers, and various plugins are often used for this task.

Unfortunately, imports can easily result in PHP or HTTP timeouts. In order to avoid these issues, you can:

  • Switch to a faster internet connection.
  • Import your files using the WP-CLI.
  • Increase your PHP timeout limit.

You may also need to contact your hosting provider for help resolving this issue.


54. WordPress Performance Issues


Your site’s performance is more or less synonymous with its speed. Fast-loading pages make for better UX and SEO, so it’s important to routinely monitor and optimize your site’s speed. Pingdom is a handy tool for testing loading times from multiple locations:

After testing your site, Pingdom will give you a list of suggestions regarding how you can improve its performance. Common solutions include image compression, caching, and enabling a CDN.


55. WordPress Is Not Sending Emails


Email marketing is a key strategy for many WordPress sites and can increase your traffic level and conversion rates. There are several plugins available that can enable you to send emails from your WordPress dashboard, conveniently bundling your email marketing platform with your site’s backend.

Often, if your emails aren’t being sent to your subscribers, it’s because of your server’s configuration. Your host may have limits on the resources your site can use, which prevents emails from going out.

If you suspect a server-related issue, contact your host. You may need to upgrade your plan. Alternatively, the plugin you’re using could be the source of the problem. Check its support forums and documentation for common issues or contact the developer for support.

Finally, emails sent from WordPress may be marked as spam. If a user contacts you about a missing email, tell them to check their junk folder just in case.




The last thing any site owner wants is for their WordPress website to become unavailable to users or showing issues. Not only does this cause you to miss out on any sales, ad views, SEO, conversions, and even affiliate commissions you might have earned.

It’ll also make your site seem less reliable and hurt your brand reputation, which could be really hard to repair.

This post will help you find a fix as easily as possible and get your business back on track quickly. Isn’t that convenient?

Do you have any questions about troubleshooting errors on your WordPress site? Ask away in the comments section below.

Comments (0)

Leave a comment

Powered by Simple Blog