WordPress is quite simple to use, as we always say. However, every now and then you come across a bug or error that just spooks you out. The good news is, most of these errors are common. Meaning, most of the errors you will encounter have been faced and solved by a WordPress user before you. In this article, we show you 10 of the most common WordPress errors and how to solve each of them.
Initially, before attempting to repair WordPress errors, backup your site. UpDraft Plus is a good plugin for this job, and we give you a good explanation why here.
If the guidelines of this article do not fix your issue, get in contact with your WordPress host.
Error 1: Syntax Error
Often, this error arises when you add code snippets into WordPress and accidentally mess up the syntax. Subsequently, this is the notice you will see:
Parse error- syntax error, unexpected $end in /public_html/site1/wp-content/themes/my-theme/functions.php on line 278
This error message indicates the exact error and where on the script this error is located. The only fix to this is simply locating the error according to the message and correcting the script.
Here is how to solve a syntax error in depth.
Error 2: Internal Server Error
The 500 Internal Server Error can be one of the most confusing WordPress errors.
Usually, you see this when the server cannot identify where something is wrong. Since the 500 error cannot indicate the location of an error’s origin, you will need to find it manually.
Error 3: 404 Error
The 404 error is a classic. This occurs when visiting a particular post or page on your site presents a 404 page – not found error instead.
Otherwise, you can usually still browse the rest of the website. WordPress’s permalink setting are the most common cause of the 404 error. Solving this requires you to reconfigure your permalinks settings. Alternatively, you can manually change your rewrite rules.
Here is how to fix 404 errors on WordPress.
Error 4: Briefly Unavailable for Scheduled Maintenance Error
Due to a WordPress update which has not completed, you may see the Briefly Unavailable for Scheduled Maintenance error.
In this case, your website goes through maintenance mode through WordPress. When this update experiences an interruption, WordPress fails to get the opportunity to quit maintenance mode. Hence, your whole site becomes unreachable by both administrators and visitors. The fix is lengthy, so check out how to fix maintenance errors in its entirety.
Error 5: Establishing a Database Connection
In the event that your website cannot connect to its database, you receive this error: Establishing a Database Connection. For a beginner, the solve to this error can be confusing.
This error arises when you input or modify your database credentials (i.e. username, host, password) incorrectly. At times, your database may become unresponsive, or even corrupted.
However, this is usually just an issue with the database login info. Here are some solutions to the establishing a database connection error.
Error 6: Mixed Content Error
Incorrect HTTPs/SSL settings are the cause of the mixed content error. This could possibly affect your site’s functionality. Undoubtedly though, WordPress errors like this will alter your site’s SEO and UX.
Simply put, resources should be loaded using an HTTPs URL on an SSL-enabled site. When your site has content with HTTP URLs, or when a plugin/theme loads a file with HTTP, those resources do not load through a secure protocol. In effect, this causes the mixed content error.
Here is the fix to the mixed content error.
Error 7: 502 Bad Gateway Error
The 502 Bad Gateway Error is at the very least, a heavy nuisance. The most common cause of this WordPress error is when a user’s request to a server times out.
Often, this request timeout is just a result of large amounts of traffic. Additionally, it could also arise from a poorly coded plugin/theme. A mistake in the server’s configuration is another explanation.
Here is how to fix error 502.
Error 8: Failed to Open Stream Error
When WordPress cannot load a file which has been mentioned in the website’s code, you get the Failed to Open Stream error. At times, WordPress will still load the site while only showing a warning. In other instances, it could cause a critical error.
Depending on what part of the code triggers the error, the error message can vary. However, in every single instance, a reason would accompany the phrase Failed to open stream. Examples of these reasons include operation failed, permission denied, etc.
Learn how to fix the failed to open stream error here.
Error 9: Pluggable.php File WordPress Errors
The file Pluggable.php holds some WordPress functions which are core. On the other hand, users can override these functions in their own coding. On the occasion that a custom code snippet or plugin cannot handle one of these functions, an error appears similar to the one shown below:
Warning: Cannot modify header information – headers already sent by (output started at /home/username/demosite/wp-content/themes/mytheme/functions.php:1035) in /home/username/demosite/wp-includes/pluggable.php on line 1179
Regardless of these WordPress errors, at times you can keep developing your site. However, in other times, this error can be critical and render your site blocked of access.
Error 10: RSS Feed Errors
The majority of WordPress RSS feed errors stem from incorrect formatting. Here is one example of such an error:
XML Parsing Error: XML or text declaration not at start of entity
Line Number 3, Column 5:
According to your browser, your RSS feed error may look different, Here is another error message you may see when viewing your feed from a browser:
Warning: Cannot modify header information – headers already sent by (output started at /home/username/example.com/wp-content/themes/twentysixteen/functions.php:433) in /home/username/abc123.com/wp-includes/pluggable.php on line 3429
XML is a strict markup language, and also happens to be the language in which WordPress outputs an RSS feed. Something as simple as one excess tab or a missing line break can trigger an RSS feed error. Here are some fixes to an RSS feed error.
To conclude, we hope this has resolved some of the issues you may have been facing with your WordPress site. To reiterate, as frequent as WordPress errors may be, the fact that they are common means that most of these errors already have ready solutions.