WordPress is one of the leading & easiest website development and web design platforms, but even with its seemingly fool-proof architecture and mechanism, users may encounter several errors.
Most of these are fairly common and easily fixable by you, but at times you may need to seek the help of your website developer for more knotty issues.
Below we have compiled a list of 7 most common errors that you may encounter during WordPress website development or administration. We have also provided the solutions to fix these WordPress website issues.
#1 White Screen of Death (WSOD)
Let’s start with the scary one, this one will render your screen pitch blank with no error messages or information of any kind. Try the following to fix this:
- Try enabling the debugging to check what the real issue behind the WSOD is. Enable debugging by opening the “wp-config.php” file and look for the following code and change the false attribute to true to turn on debugging.
- Revert to your default theme as at times corrupt or broken themes may also cause the white screen issue.
- You can also try disabling all the plugins that change the look of your website as well as your dashboard. Such plugins also cause this error.
- At times, your website may fall on short on memory, so raising the memory limit may also solve the issue. Increase the maximum limit by making changes in the php.ini file.
#2 Internal Server Error
This is similar to WSOD as the server does not identify the cause of the error and you don’t know where and how to fix it. Try the following:
- Rename the .htaccess file and load the site to check if the issue is resolved. If it is fixed, generate a new .htaccess file by going to Settings => Permalinks and resetting the permalinks.
- Deactivate plugins and check if the plugins are causing the issues. If the admin screen is not available, use the FTP route to deactivate the plugins.
- Or you can even try reverting to the default theme in WordPress.
#3 Connection Timeout Error
It can arise from your website trying to manage several connections with very limited resources.
- You can fix it by deactivating your plugins one at a time and checking for website access. If any of the plugins is causing this, deactivating it will fix the problem.
- You can also try raising the memory limit of the website. This can be done by accessing php.ini file and resetting the maximum memory in it.
- Also, try reverting to your default WordPress theme as corrupt or heavy themes may also cause timeout issues.
#4 Database Connection Error
This essentially means that your website is having issues connecting to the database. You can find this a bit intimidating, but here are some common fixes, which are sure to sort the issue out.
- The most common issue is incorrect login credentials. Open the wp-config.php file and check if the username, password, database name, and host address are correct. If not, changing them to the correct ones will solve the issue.
- Check the wp-admin page of your website, and if shows that any of your databases is not available and you may need to repair it, then enter your website using the FTP route and edit the wp-config.php file by adding the following piece of code to it.
define( ‘WP_ALLOW_REPAIR’, true )
Save the changes to the file and upload it to the server. Next visit the link https://[websiteurl].com/wp-admin/maint/repair.php.
On the page that opens, run the repair tool. Once the database errors are fixed, a webpage will inform you about the same. Remove the extra line of code we added earlier to the wp-config.php file.
#5 Parse or Syntax Error
This is the result of a faulty line of code, mainly within the functions.php file. A message indicating the file and location of the faulty code within it will appear when you try loading the webpage. You can fix it by doing the following:
Go to the file in question and open it in the View/Edit mode, scroll to the line at which the problem is indicated and fix the issue. Most of the times, it is either a missing comma or parenthesis or insertion of some unintended character in the code. Fix the issue and save the file. When prompted by the FTP to replace it, click on yes.
Again, since this fix involves codes editing, you must seek a professional WordPress developer, when in doubt.
#6 WordPress Not Uploading Images
It is highly common that, at times, your images may not get uploaded properly to the media library or they may not get uploaded at all. This is mostly due to incorrect file permissions. To fix this, try the following:
Using SFTP, navigate to the Uploads folder in the wp-content directory. Right-click on this folder and select File Permissions. In the permissions settings, set the number value to 744, which will allow you to read and write uploads. Click ok to confirm this. These permissions need to be set for all files within the folder, so right-click on the Uploads folder once again and using file permissions, set the value to 644. Now check on the Recurse into Subdirectories option and choose to apply this to the files only. Save the changes and you will find that your uploads are working fine. Check this by uploading a fresh image to the media library.
#7 WordPress Stuck In Maintenance Mode
During an update, maintenance mode may get auto-enabled, which disables your website to prevent users from accessing your site’s functionalities and cause unnecessary issues.
However, for some reason, if the update is cancelled before completion, your website will get stuck in the maintenance mode for an undefined period of time. Do not panic as this is a very easy to fix issue.
To get out of the maintenance mode, access the root folder of your website using the SFTP. Once inside the root folder, find and delete the file named “.maintenance”. Removing this file will take your website out of the maintenance mode and back to normal.
Above are some of the common errors you might encounter while using WordPress for your website development. If the problem still persists, which is very rare, you may consider contacting your website developer or hosting solution provider as the issue may be more complex and involve multiple factors.