Running into errors on your WordPress site tin exist intimidating. Notwithstanding, near errors give you lot some inkling as to what acquired them, which tin brand troubleshooting these common issues a lot easier. The 503 error is not every bit polite, unfortunately, and doesn't give yous much data to go on.

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

In this commodity, we'll cover what the 503 error is and how it typically manifests. And then nosotros'll guide yous through six steps in lodge to troubleshoot it. Allow's get to work!

What Is an HTTP Fault 503?

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

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

When you encounter the 503 fault, it ways that the server in question is unavailable. That could be because information technology'south likewise decorated, for example, or it's nether maintenance. Dissimilar other similar error codes, 503 signifies that your website is online and running, merely can't exist reached at the present moment.

What's and then vexing about this particular error is that it barely gives you any data to go on. Almost of the time, it just shows up with a "Service temporarily unavailable" message. That'due south the equivalent of calling a restaurant via phone, only to have them tell yous that they're closed but refuse to permit you know when they'll be open once more.

If yous're lucky, the 503 error lawmaking volition have occurred because your WordPress website is nether maintenance. WordPress very briefly sets your site to maintenance style when you're updating a plugin, a theme, or the cadre software:

HTTP 503 Error in WordPress
Maintenance way

Usually, this timeout is so brief that no one volition find information technology. However, in those cases where the 503 error persists, you'll have a bigger problem to deal with. Subsequently all, not only will users be unable to visit your site, just you'll lose access to your WordPress admin surface area besides. That ways y'all can't update your site in whatever way, and in order to troubleshoot it, you'll demand to dig into its files.

503 Error Variations

The 503 error can prove upward in a lot of ways. However, near every variation comes accompanied by that 503 lawmaking, making information technology easy to identify.

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

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

Whatever the lawmaking y'all run across might look like, information technology means you need to become to work fast before it affects your users negatively.

Have you ever meet the 503 error in WordPress? That's a bummer! 😱Follow these 6 steps to ready it and get your site dorsum online in no seconds! Click to Tweet

How to Fix the 503 Error in WordPress (half-dozen Steps)

Since you oft can't be sure what caused the 503 mistake in any given situation, you'll need to go about troubleshooting information technology methodically. The post-obit six sections each cover a potential fix, aimed at resolving the different potential root causes.

After each step, take a moment to return to your website and see if the 503 error is gone. If it is, you've successfully stock-still the upshot. If non, continue on to the next step in the process.

ane. Temporarily Deactivate Your WordPress Plugins

One of the most common causes of the 503 fault in WordPress is plugin compatibility issues. To decide if that's what'due south happening, you'll need to disable all of your site's plugins.

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

One time your FTP client is ready, connect to your website through it and navigate to your WordPress root folder. In instance y'all tin can't find it, it'southward usually called public_html, html, public, www, or your site's proper noun. If you're a Kinsta client, it'south your public binder.

WordPress root folder SFTP
WordPress root binder SFTP

Open that folder, and navigate to the wp-content directory. Within, yous'll see a binder called plugins, which contains individual subdirectories for each of the plugins installed on your site (both active and inactive).

What yous're going to practise now is right-click on the plugins folder, and rename it to something else. We recommend plugins.one-time or plugins.deactivated, so you can easily recognize it later.

WordPress plugins folder renamed
WordPress plugins folder renamed

WordPress will now not be able to find whatever of your plugins. When that happens, information technology will automatically disable those plugins.

At present, endeavor accessing your WordPress dashboard. If the 503 fault is gone, and so you can assume that one of your plugins was the culprit. All you have to do is figure out which one was at mistake.

Render to the wp-content directory, and rename your original plugins folder correctly. And so, you'll need to disable each of your plugins one past one, until you detect the culprit.

To exercise this, open the wp-content/plugins directory. Inside, yous'll find one folder for each of your plugins. The procedure yous're going to follow is much the same equally before:

  1. Start with the start binder, and rename it to annihilation you like.
  2. Check your website to see if the error is gone.
  3. If information technology isn't, return the plugin binder from the previous step to its original name.
  4. Movement on to the next plugin on your listing, repeating the in a higher place steps.

This process tin accept a while if yous have a lot of plugins, merely it's vital to check each plugin in turn. If at any point y'all place the plugin that's causing the error, you can uninstall it or replace it with another tool.

If you brand information technology to the end of these steps without finding a solution, you can move on to the next stage of troubleshooting.

2. Conciliate Your WordPress Theme

Now that yous've ruled out your plugins every bit the crusade of the 503 fault, it's fourth dimension to do the same with your active theme. In fact, your theme could besides be creating compatibility issues.

Unfortunately, the procedure doesn't work the same as to a higher place. WordPress won't revert to the default theme if just rename the theme binder, yous would end up with an error like "The theme directory "theme name" does non be." Or if you try to rename the unabridged theme directory folder, you terminate upward with "Fault: 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 fault

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

MyKinsta phpMyAdmin
MyKinsta phpMyAdmin

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

phpMyAdmin wp_options table
phpMyAdmin wp_options table

Under the "option_value" column y'all volition run across the current proper noun of your theme. Change this to one of the default themes, such every bit "twentynineteen."

Subscribe At present

wp_options template name
wp_options template proper name

Check your website again to run into if this has stock-still the error. If it did, it simply means it'southward a problem with your WordPress theme and y'all might want to try reinstalling information technology or reverting to your most recent backup.

3. Temporarily Disable Your Content Delivery Network (CDN)

Sometimes, the 503 mistake will show upward 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's the case is to temporarily disable information technology.

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

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

The process y'all demand to follow may exist different depending on which CDN you're using. Cloudflare has also been known to crusade 503 errors sometimes. If you can't find the option to pause yours, check out your service'southward knowledge base, which will usually contain detailed instructions.

If you lot don't use a CDN or find that pausing your service doesn't help with your upshot, in that location are yet a few more fixes to endeavour. Do think to reactivate your CDN before moving on.

four. Limit the WordPress 'Heartbeat' API

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

Just like a regular heartbeat, the API works in the background with a high frequency so that it doesn't miss anything. Every bit you might imagine, this API consumes server resources. Usually, that's non a problem but in some cases, information technology may lead to a 503 error if your server tin't handle the load.

The quickest fashion to determine if the Heartbeat API is at the center of your problems is to temporarily disable information technology. To practise that, connect to your WordPress website via FTP once more than, and then open up 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 option, which will open up it using your local text editor. Once it'due south open up, you'll need to add together the post-obit code snippet inside:

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

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

If the 503 error is gone, yous'll know that the API was the trouble. Disabling it altogether removes a lot of useful functionality, nevertheless. Instead, we recommend that you 'dull downwardly' the Heartbeat, so that it doesn't crusade problems.

The easiest way to practise that is by installing the Heartbeat Control plugin. Activate the plugin and navigate to the Settings > Heartbeat Command section. Look for the Modify Heartbeat options, and drop the frequency to the lowest possible number:

Heartbeat Control plugin frequency
Heartbeat Control plugin frequency

Relieve the changes to your settings and return to the functions.php file you tweaked a while back. For the above changes to work, you'll demand to remove the string of code you added before and relieve your changes to the file.

At this stage, the 503 error should be gone if the Heartbeat API was the trouble. If information technology isn't, then information technology'south time to endeavour something different.

v. Increase Your Server's Resources

If the 503 error is still occurring despite all your attempts to prepare it and then far, then there's a skilful chance the problem might exist due to a lack of server resources. That is to say, y'all'll need to upgrade your hosting programme to encounter if that fixes the outcome. This is especially truthful if you're using cheap WordPress hosting, every bit they tend to throttle resources. We don't practise this at Kinsta.

Upgrading your programme is a big decision, however. The smart move is to first contact your web hosting support service and talk over the 503 error with them, also as the steps you've taken and so far to try and solve it. The support squad should be able to help yous work out the cause and advise you on whether you demand to upgrade your plan or not.

6. Review Your Logs and Enable WP_DEBUG

Y'all should also take advantage of your fault logs. If you lot're a Kinsta client, you can easily see errors in the log viewer and enable WordPress debug mode in the MyKinsta dashboard. This tin can help you chop-chop narrow down the effect, especially if information technology's resulting from a plugin on your site.

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

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

                      define            (            'WP_DEBUG'            ,            truthful            )            ;            define            (            'WP_DEBUG_LOG'            ,            true            )            ;            define            (            'WP_DEBUG_DISPLAY'            ,            false            )            ;                  

The logs are typically located in the /wp-content directory. Within it, wait for a file called debug.log and open it up.

Others, like here at Kinsta might accept a dedicated folder called "logs".

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

Interpreting your debug log can be a flake intimidating only it's not every bit difficult to read as y'all might imagine. In a nutshell, the log contains each mistake that pops upwardly on your site in chronological order. It shows which file caused each mistake, every bit well equally which specific lines of code were involved.

Beware: you're not going to notice direct references to the 503 mistake within your log. Yet, if all else fails, it can point you in the right management by showing you what files are causing problems. That way, yous'll know where to focus your efforts side by side. Every bit we mentioned in the previous stride, at present is a good time to arrive touch with your hosting provider if yous need further assistance resolving this error.

You lot can likewise cheque the log files in Apache and Nginx, which are commonly 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 also take advantage of our analytics tool to go a breakdown of the total number of 503 errors and run across how frequently and when they are occurring. This can help you troubleshoot if this is an ongoing issue, or perhaps something that has resolved itself.

If the 503 fault is displaying because of a fatal PHP error, you tin likewise effort enabling PHP fault reporting. Simply add the following code to the file throwing the error. Typically yous tin can narrow down the file in the console tab of Google Chrome DevTools.

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

And you lot might need to also modify your php.ini file with the post-obit:

          display_errors            =            on        

Summary

If you're lucky, the 503 error volition just show upwardly when you put your website into maintenance manner. However, if it appears without alarm, then you'll take to roll up your sleeves and do some troubleshooting.

To go at the root cause of the 503 mistake, you lot'll need to follow these steps to fix it:

  • Temporarily conciliate your WordPress plugins.
  • Deactivate your WordPress theme.
  • Disable your CDN.
  • Limit the WordPress Heartbeat API.
  • Increase your server resources.
  • Review your logs and enable WP_DEBUG.

Accept yous ever see the HTTP 503 fault in WordPress? Share your experiences with us in the comments department below!


Save fourth dimension, costs and maximize site performance with:

  • Instant help from WordPress hosting experts, 24/7.
  • Cloudflare Enterprise integration.
  • Global audience accomplish with 29 data centers worldwide.
  • Optimization with our built-in Application Functioning Monitoring.

All of that and much more, in one plan with no long-term contracts, assisted migrations, and a 30-day-coin-back-guarantee. Bank check out our plans or talk to sales to find the plan that'southward right for y'all.