Running into errors on your WordPress site tin be intimidating. However, most errors give you some inkling as to what acquired them, which can make troubleshooting these common issues a lot easier. The 503 error is not equally polite, unfortunately, and doesn't requite y'all much information to go on.

It helps to understand what the virtually common causes are for the 503 error in WordPress. After that, you lot'll need to be methodical when it comes to troubleshooting the error, which means following several steps in order to locate the root cause.

In this article, we'll cover what the 503 error is and how information technology typically manifests. Then we'll guide you through vi steps in social club to troubleshoot it. Let's get to work!

What Is an HTTP Error 503?

The Internet Engineering Job Force (IETF) defines the 503 Service Unavailable as:

The 503 (Service Unavailable) status code indicates that the server is currently unable to handle the asking due to a temporary overload or scheduled maintenance, which volition probable be alleviated later on some delay. The server MAY send a Retry-After header field to propose an appropriate amount of time for the client to wait before retrying the request.

When you encounter the 503 error, it means that the server in question is unavailable. That could exist because it's as well busy, for example, or information technology's under maintenance. Dissimilar other similar error codes, 503 signifies that your website is online and running, simply can't be reached at the present moment.

What's and then vexing almost this detail error is that information technology barely gives y'all any information to proceed. Most of the fourth dimension, information technology just shows up with a "Service temporarily unavailable" bulletin. That's the equivalent of calling a eatery via phone, only to have them tell you that they're closed just refuse to let you know when they'll be open again.

If you're lucky, the 503 error code volition accept occurred because your WordPress website is under maintenance. WordPress very briefly sets your site to maintenance way when you're updating a plugin, a theme, or the core software:

HTTP 503 Error in WordPress
Maintenance manner

Usually, this timeout is so cursory that no one will notice information technology. Yet, in those cases where the 503 error persists, you'll have a bigger problem to deal with. After all, non simply will users be unable to visit your site, but you'll lose access to your WordPress admin area likewise. That means you tin't update your site in whatever mode, and in order to troubleshoot it, yous'll need to dig into its files.

503 Mistake Variations

The 503 error can testify up in a lot of ways. Notwithstanding, almost every variation comes accompanied past that 503 code, making it like shooting fish in a barrel to identify.

Here are some of the variations you might encounter, depending on your server configuration and browser:

  • 503 Service Unavailable
  • 503 Service Temporarily Unavailable
  • HTTP Server Error 503
  • HTTP Fault 503
  • Mistake 503 Service Unavailable
  • The server is temporarily unable to service your request due to maintenance downtime or capacity problems. Please try again subsequently.

Whatever the code y'all run into might look like, information technology ways you need to get to piece of work fast before it affects your users negatively.

Have you ever encounter the 503 error in WordPress? That's a bummer! 😱Follow these half dozen steps to fix it and get your site back online in no seconds! Click to Tweet

How to Set up the 503 Error in WordPress (6 Steps)

Since you oftentimes can't be sure what caused the 503 mistake in any given situation, you'll need to go near troubleshooting it methodically. The following six sections each encompass a potential ready, aimed at resolving the different potential root causes.

Afterwards each footstep, take a moment to return to your website and run into if the 503 fault is gone. If it is, you've successfully fixed the result. If non, continue on to the next step in the procedure.

1. Temporarily Deactivate Your WordPress Plugins

Ane of the well-nigh mutual causes of the 503 error in WordPress is plugin compatibility bug. To decide if that's what's happening, yous'll demand to disable all of your site'south plugins.

Since the 503 error prevents you lot from accessing the WordPress admin area, you'll need to use an FTP client for this step. If you don't have one set upwardly, we recommend FileZilla.

In one case your FTP client is ready, connect to your website through information technology and navigate to your WordPress root binder. In case you lot can't observe it, it's usually chosen public_html, html, public, world wide web, or your site's name. If you're a Kinsta customer, it's your public folder.

WordPress root folder SFTP
WordPress root folder SFTP

Open up that folder, and navigate to the wp-content directory. Inside, y'all'll run across a folder called plugins, which contains individual subdirectories for each of the plugins installed on your site (both agile and inactive).

What you're going to do at present is right-click on the plugins folder, and rename information technology to something else. Nosotros recommend plugins.old or plugins.deactivated, so you can easily recognize it later on.

WordPress plugins folder renamed
WordPress plugins folder renamed

WordPress volition now non be able to find any of your plugins. When that happens, information technology volition automatically disable those plugins.

Now, try accessing your WordPress dashboard. If the 503 fault is gone, then you can presume that ane of your plugins was the culprit. All you accept to do is figure out which one was at fault.

Return to the wp-content directory, and rename your original plugins binder correctly. Then, yous'll demand to disable each of your plugins one by i, until yous observe the culprit.

To do this, open the wp-content/plugins directory. Inside, you'll find i binder for each of your plugins. The process y'all're going to follow is much the same as before:

  1. Start with the first folder, and rename it to anything you like.
  2. Cheque your website to see if the fault is gone.
  3. If it isn't, render the plugin folder from the previous step to its original proper noun.
  4. Motion on to the next plugin on your listing, repeating the to a higher place steps.

This process can take a while if you lot have a lot of plugins, but it'south vital to check each plugin in plough. If at any indicate you place the plugin that's causing the error, you can uninstall information technology or supercede it with another tool.

If you make it to the terminate of these steps without finding a solution, you tin move on to the next stage of troubleshooting.

2. Deactivate Your WordPress Theme

Now that you lot've ruled out your plugins as the cause of the 503 error, it'due south time to do the aforementioned with your active theme. In fact, your theme could also be creating compatibility issues.

Unfortunately, the process doesn't work the same as above. WordPress won't revert to the default theme if but rename the theme folder, y'all would end upward with an error like "The theme directory "theme name" does not exist." Or if yous effort to rename the unabridged theme directory binder, you cease upwardly with "Error: The themes directory is either empty or doesn't be. Please check your installation."

The theme directory does not exist error
The theme directory does not exist error

Therefore, you need to access your WordPress database by logging into phpMyAdmin. If you're a Kinsta client, this can be found within the "Info" section of the MyKinsta dashboard.

MyKinsta phpMyAdmin
MyKinsta phpMyAdmin

Click into the "wp_options" tabular array, then click on the "Search" tab. You volition want to search under the "option_name" for template.

phpMyAdmin wp_options table
phpMyAdmin wp_options table

Nether the "option_value" column yous will see the current name of your theme. Modify this to ane of the default themes, such as "twentynineteen."

Subscribe Now

wp_options template name
wp_options template name

Check your website over again to see if this has fixed the error. If it did, it simply means it'south a problem with your WordPress theme and you might want to try reinstalling it or reverting to your most recent backup.

3. Temporarily Disable Your Content Delivery Network (CDN)

Sometimes, the 503 fault will show upwards not because of a problem on your website, but because of your Content Delivery Network (CDN). If you're using a CDN, a quick way to figure out if that'south the case is to temporarily disable it.

Every CDN should include some feature that enables yous to break its services. If you're on Kinsta, y'all can disable your Kinsta CDN by navigating to CDN → "Disable CDN" within your MyKinsta dashboard:

MyKinsta CDN enable/disable option
MyKinsta CDN enable/disable option

The process you demand to follow may be unlike depending on which CDN yous're using. Cloudflare has as well been known to cause 503 errors sometimes. If you can't find the option to intermission yours, check out your service's cognition base, which will usually contain detailed instructions.

If you don't apply a CDN or notice that pausing your service doesn't aid with your issue, there are still a few more fixes to try. Do remember to reactivate your CDN earlier moving on.

4. Limit the WordPress 'Heartbeat' API

The WordPress Heartbeat is an API built into WordPress, which the platform uses for auto-saving content, showing you plugin notifications, letting you know when someone else is working on a post you lot're trying to admission, and more.

Merely like a regular heartbeat, the API works in the background with a high frequency and so that it doesn't miss anything. As you might imagine, this API consumes server resource. Unremarkably, that's not a problem just in some cases, it may lead to a 503 error if your server tin can't handle the load.

The quickest way to determine if the Heartbeat API is at the heart of your bug is to temporarily disable it. To practice that, connect to your WordPress website via FTP one time more, and so open your current themes folder and look for the functions.php file within:

WordPress theme functions.php file
WordPress theme functions.php file

Right-click on the file and select the View/Edit pick, which will open information technology using your local text editor. One time information technology'due south open, you lot'll need to add the following code snippet inside:

          add_action( 'init', 'stop_heartbeat', ane ); role stop_heartbeat() { wp_deregister_script('heartbeat'); }        

Those three lines of code tell WordPress to disable the Heartbeat API. Save the changes to the functions.php file, close information technology, and effort to access your website again.

If the 503 fault is gone, you'll know that the API was the trouble. Disabling information technology birthday removes a lot of useful functionality, however. Instead, nosotros recommend that you 'ho-hum down' the Heartbeat, so that it doesn't cause problems.

The easiest fashion to do that is past installing the Heartbeat Control plugin. Activate the plugin and navigate to the Settings > Heartbeat Control section. Look for the Modify Heartbeat options, and drib the frequency to the lowest possible number:

Heartbeat Control plugin frequency
Heartbeat Control plugin frequency

Save the changes to your settings and render to the functions.php file you tweaked a while dorsum. For the above changes to piece of work, you lot'll need to remove the cord of code yous added before and salve your changes to the file.

At this phase, the 503 error should be gone if the Heartbeat API was the problem. If it isn't, then it's time to try something different.

5. Increment Your Server's Resource

If the 503 error is still occurring despite all your attempts to set information technology so far, and so in that location'due south a good risk the problem might be due to a lack of server resources. That is to say, you'll need to upgrade your hosting plan to see if that fixes the issue. This is especially true if you're using cheap WordPress hosting, as they tend to throttle resource. We don't exercise this at Kinsta.

Upgrading your programme is a big determination, however. The smart move is to first contact your web hosting support service and discuss the 503 error with them, besides as the steps you've taken so far to effort and solve information technology. The support team should be able to help you piece of work out the cause and suggest yous on whether you need to upgrade your plan or not.

At Kinsta, our support squad is more than than happy to accept a expect for you lot. We can fifty-fifty temporarily enable New Relic to see if we can pinpoint the issue down to something on your site that is causing the problem.

half dozen. Review Your Logs and Enable WP_DEBUG

You should too take advantage of your mistake logs. If you're a Kinsta client, you can easily see errors in the log viewer and enable WordPress debug fashion in the MyKinsta dashboard. This can aid you lot apace narrow downwards the issue, especially if it's resulting from a plugin on your site.

Check error logs for HTTP 503 errors
Check error logs for 503 errors

If your host doesn't have a logging tool, y'all tin can too add the following code to your wp-config.php file to enable logging:

                      define            (            'WP_DEBUG'            ,            true            )            ;            define            (            'WP_DEBUG_LOG'            ,            true            )            ;            define            (            'WP_DEBUG_DISPLAY'            ,            imitation            )            ;                  

The logs are typically located in the /wp-content directory. Inside it, look for a file chosen debug.log and open information technology upwards.

Others, like hither at Kinsta might accept a dedicated binder called "logs".

WordPress error logs folder (SFTP)
WordPress error logs folder (SFTP)

Interpreting your debug log tin be a scrap intimidating just it's not as hard to read every bit you lot might imagine. In a nutshell, the log contains each error that pops up on your site in chronological lodge. Information technology shows which file caused each error, as well equally which specific lines of code were involved.

Beware: yous're not going to find direct references to the 503 fault within your log. Even so, if all else fails, it can point you in the right direction by showing you what files are causing issues. That way, yous'll know where to focus your efforts next. As we mentioned in the previous stride, now is a good time to arrive touch with your hosting provider if you lot need further aid resolving this fault.

You can besides cheque the log files in Apache and Nginx, which are ordinarily located here:

  • Apache: /var/log/apache2/error.log
  • Nginx: /var/log/nginx/error.log

To learn more, please check out our web server showdown: Nginx vs Apache.

If you're a Kinsta customer you can besides have reward of our analytics tool to become a breakup of the total number of 503 errors and encounter how often and when they are occurring. This can help you lot troubleshoot if this is an ongoing event, or perhaps something that has resolved itself.

If the 503 error is displaying because of a fatal PHP mistake, y'all can also attempt enabling PHP error reporting. Simply add together the following code to the file throwing the error. Typically you tin can narrow downward the file in the panel tab of Google Chrome DevTools.

                      ini_set            (            'display_errors'            ,            1            )            ;            ini_set            (            'display_startup_errors'            ,            1            )            ;            error_reporting            (            E_ALL            )            ;                  

And you lot might need to too change your php.ini file with the following:

          display_errors            =            on        

Summary

If y'all're lucky, the 503 mistake will only show upward when y'all put your website into maintenance mode. However, if it appears without alert, then you'll take to whorl up your sleeves and do some troubleshooting.

To get at the root cause of the 503 mistake, you'll need to follow these steps to ready information technology:

  • Temporarily deactivate your WordPress plugins.
  • Conciliate your WordPress theme.
  • Disable your CDN.
  • Limit the WordPress Heartbeat API.
  • Increase your server resource.
  • Review your logs and enable WP_DEBUG.

Have you lot always see the HTTP 503 error in WordPress? Share your experiences with us in the comments department below!


Save time, costs and maximize site performance with:

  • Instant help from WordPress hosting experts, 24/7.
  • Cloudflare Enterprise integration.
  • Global audience attain with 29 information centers worldwide.
  • Optimization with our built-in Awarding Performance Monitoring.

All of that and much more, in one plan with no long-term contracts, assisted migrations, and a 30-twenty-four hour period-coin-back-guarantee. Check out our plans or talk to sales to find the plan that'south right for you.