{"id":23319,"date":"2022-09-22T11:39:00","date_gmt":"2022-09-22T07:39:00","guid":{"rendered":"https:\/\/www.cs-cart.com\/blog\/?p=23319"},"modified":"2026-04-22T11:41:57","modified_gmt":"2026-04-22T07:41:57","slug":"503-service-unavailable-error","status":"publish","type":"post","link":"https:\/\/www.cs-cart.com\/blog\/503-service-unavailable-error\/","title":{"rendered":"How to Fix the HTTP 503 Service Unavailable Error in CS-Cart"},"content":{"rendered":"\n

Running into errors on your CS-Cart project can be intimidating. However, most errors give you a clear clue as to what caused them, which can make troubleshooting these common issues a lot easier.<\/p>\n\n\n\n

Unfortunately, a 5xx error or particularly a 503 error is not very polite to your business. However, it sometimes provides you much information to go on. It helps to understand what the most common causes are for the errors in\u00a0CS-Cart<\/a>\u00a0or\u00a0Multi-Vendor<\/a>. After finding the reasons, you will need to investigate the root cause and fix the error, which means following several steps to locate the root cause.<\/p>\n\n\n\n

In this post, we will cover what the 503 error is and how it typically manifests itself. Then we\u2019ll guide you through several steps on how to troubleshoot it.<\/p>\n\n\n\n

<\/path><\/svg><\/div>
We all know that 503 errors happen on the server-side, but the initiator of this error is PHP.<\/div><\/div><\/div>\n\n\n\n

What is error 503 SERVICE UNAVAILABLE?<\/h2>\n\n\n\n
\n

The 503 (Service Unavailable) HTTP status code indicates that the server is currently unable to handle the request due to a temporary overload or scheduled maintenance, which will likely be alleviated after some delay.<\/p>\nhttps:\/\/datatracker.ietf.org\/doc\/html\/rfc7231?roistat_visit=1043885#section-6.6.4<\/a><\/cite><\/blockquote>\n\n\n\n

When you face the \u201c503 Service Temporarily Unavailable\u201d error, it means that your request (page opening, for example) has come to the server, but the response is not available due to some cause. That could be because the server is too busy, for example, or it\u2019s under maintenance. Unlike other similar error codes, error 503 shows that your website is online and running, but can\u2019t be reached out at the present moment. And in most cases, you can find out the root cause of this error on this page!<\/p>\n\n\n\n

\"How
\u201cSorry, service is temporarily unavailable\u201d error shows the root cause in CS-Cart<\/figcaption><\/figure>\n\n\n\n

How to find 503 Service Unavailable Error in CS-Cart<\/h2>\n\n\n\n

Follow these steps to identify the root cause of the 503 error \u201cService Unavailable\u201d error in CS-Cart:<\/p>\n\n\n\n

View source code of current page<\/h3>\n\n\n\n

Right-click the page and select \u201cInspect<\/strong>\u201c<\/p>\n\n\n\n

Scroll down to the HTML comment<\/h3>\n\n\n\n

And you will see the error text. They can point to the add-on, theme, or any function in the code.<\/p>\n\n\n\n

Analyze the error message<\/h3>\n\n\n\n

\u2013 \u201cMessage\u201d will show the root cause of the issue
\u2013 \u201cError at\u201d and \u201cBacktrace\u201d will show the problem component. Examine the path to the error carefully, if, for example, the problem is in an add-on, you will see its name in the path \u201c\u2026app\/addons\/[name]\/\u2026\u201d.<\/p>\n\n\n\n

Isolate the problem place, try to apply a workaround<\/h3>\n\n\n\n

Disable, delete, reinstall add-on or revert your latest actions, etc\u2026<\/p>\n\n\n\n

Make a Screenshot and Contact Support<\/h3>\n\n\n\n

Send the screenshot to your support team, developers, or hosting provider so they can identify the issue and apply a solution \ud83d\ude09.<\/p>\n\n\n\n

\n
Fix the HTTP 503 Error with us!<\/a><\/div>\n<\/div>\n\n\n\n

How to fix the 503 error in CS-Cart and Multi-Vendor<\/h2>\n\n\n\n

Since sometimes you can\u2019t be sure what caused the 503 server error or you can\u2019t guess the root cause from the message. In any given situation, you\u2019ll need to go about troubleshooting it methodically. The following steps, each covering a potential fix, aimed at resolving the different potential root causes.<\/p>\n\n\n\n

Revert your latest actions<\/h3>\n\n\n\n

If you did something and after it, your project is broken \u2013 revert your action. Simple, isn\u2019t it? \ud83d\ude42<\/p>\n\n\n\n

Sometimes, to restore a website, you need to take action via SSH\/sFTP file changes or some database modifications. If you need help, contact your hosting provider and also request an investigation of this case.<\/p>\n\n\n\n

Contact the developer team or add-on developers<\/h3>\n\n\n\n

If you don\u2019t have a development team and the error on your website is still showing, contact the CS-Cart team. Our professional developers, in close communication with the system administration team, will investigate the root cause and fix it.<\/p>\n\n\n\n

\n
Contact us<\/a><\/div>\n<\/div>\n\n\n\n

Temporarily deactivate add-ons and theme<\/h3>\n\n\n\n

The 503 error \u201cService Temporarily Unavailable\u201d may come up after\u00a0a CS-Cart or Multi-Vendor upgrade\u00a0without checking backward compatibility with the old versions of the add-ons and themes. Sometimes, it happens because the version of the add-on is not compatible with the\u00a0PHP version\u00a0or incompatible with the add-on or theme settings.<\/p>\n\n\n\n

In this case, we recommend reverting your latest actions.<\/p>\n\n\n\n

Increase your server\u2019s resources (plan)<\/h3>\n\n\n\n

If the 503 error is still occurring despite all your attempts to fix it so far, then there\u2019s a good chance to\u00a0increase your plan\u00a0as the problem might be due to a lack of server resources. That is to say, you will need to upgrade your hosting plan to see if that fixes the issue. In many cases, the root cause is an unoptimized PHP code and SQL queries, which lead to an extra high load.<\/p>\n\n\n\n

Upgrading your plan is a big decision, however. A smart move is first to contact your web hosting support service and discuss the 503 error and the steps you\u2019ve taken so far with them to solve it. The support team should be able to help you work out the cause and advise you on whether you need to upgrade your plan or not.<\/p>\n\n\n\n

With CS-Cart hosting and support services, the team can analyze performance, identify bottlenecks, and resolve issues through custom optimizations. We can even make a performance investigation, enable extra logging and profiling of any piece of code to find the root cause. We can pinpoint the bottleneck to something on your site that is causing the problem and prepare a report on it.<\/p>\n\n\n\n

\n
Get Help from CS-Cart Experts<\/a><\/div>\n<\/div>\n\n\n\n

Temporarily deactivate Content Delivery Network (CDN) and proxying via Cloudflare<\/h3>\n\n\n\n

Sometimes, the 503 error will show up not because of a problem on your website, but because of your Content Delivery Network (CDN) or any proxying server issue. If you\u2019re using a CDN or Cloudflare service, a quick way to figure out if that\u2019s the root cause is to temporarily disable it and check in a different network (via mobile or other Wi-Fi).<\/p>\n\n\n\n

Review log files and enable extra debug in PHP to find the issue<\/h3>\n\n\n\n

It would help if you also take advantage of your error logs for PHP Fatal errors, Warnings, and Notices. This can help you quickly narrow down the issue, especially if it\u2019s resulting from an add-on on your website.<\/p>\n\n\n\n

If your hoster doesn\u2019t provide log files or you can\u2019t find them, you can also add the following code to your\u00a0local_conf.php<\/code>\u00a0file (if you don\u2019t have it, create a new one) to enable logging. But before it, you need to\u00a0know your IP address<\/a>\u00a0and replace it inside\u00a0$accessibleIps<\/code>\u00a0variable.<\/p>\n\n\n\n

Debugging via \"local_conf.php\"<?php<\/strong>\n\n$accessibleIps = array(\n    '123.123.123.123',\n);\n\nif (\n    !in_array($_SERVER['REMOTE_ADDR'], $accessibleIps)\n    && (\n        empty($_SERVER['SERVER_NAME'])\n        || $_SERVER['SERVER_NAME'] != 'localhost'\n    )\n) {\n    exit;\n}\n\ndefine('DEVELOPMENT', true);\nerror_reporting(E_ALL);\nini_set('display_errors', 'On');\ndefine('DEBUG_MODE', true);\nini_set('error_log', 'var\/php-error.log');\n<\/code><\/pre>\n\n\n\n
And the log file will be located in the \/var<\/code> directory in your website root directory. Inside it, look for a file named as php-error.log<\/code> and open it up.<\/p>\n\n\n\n
\"logs\"
In our hosting solution, we provide all necessary log files next to the directory public_html, named logs. And you don\u2019t need to make any code changes.<\/figcaption><\/figure>\n\n\n\n
\n
Contact us<\/a><\/div>\n<\/div>\n\n\n\n
<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"Running into errors on your CS-Cart project can be intimidating. However, most errors give you a clear clue…","protected":false},"author":84973,"featured_media":23326,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_ayudawp_aiss_exclude":false,"csco_singular_sidebar":"","csco_page_header_type":"","csco_page_load_nextpost":"","footnotes":""},"categories":[6,5],"tags":[],"_links":{"self":[{"href":"https:\/\/www.cs-cart.com\/blog\/wp-json\/wp\/v2\/posts\/23319"}],"collection":[{"href":"https:\/\/www.cs-cart.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.cs-cart.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.cs-cart.com\/blog\/wp-json\/wp\/v2\/users\/84973"}],"replies":[{"embeddable":true,"href":"https:\/\/www.cs-cart.com\/blog\/wp-json\/wp\/v2\/comments?post=23319"}],"version-history":[{"count":4,"href":"https:\/\/www.cs-cart.com\/blog\/wp-json\/wp\/v2\/posts\/23319\/revisions"}],"predecessor-version":[{"id":23325,"href":"https:\/\/www.cs-cart.com\/blog\/wp-json\/wp\/v2\/posts\/23319\/revisions\/23325"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.cs-cart.com\/blog\/wp-json\/wp\/v2\/media\/23326"}],"wp:attachment":[{"href":"https:\/\/www.cs-cart.com\/blog\/wp-json\/wp\/v2\/media?parent=23319"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.cs-cart.com\/blog\/wp-json\/wp\/v2\/categories?post=23319"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.cs-cart.com\/blog\/wp-json\/wp\/v2\/tags?post=23319"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}