{"id":9782,"date":"2026-06-07T15:04:39","date_gmt":"2026-06-07T13:04:39","guid":{"rendered":"https:\/\/mybox.com\/help\/?post_type=manual_kb&#038;p=9782"},"modified":"2026-06-08T09:28:47","modified_gmt":"2026-06-08T07:28:47","slug":"how-to-enable-debug-mode-in-prestashop","status":"publish","type":"manual_kb","link":"https:\/\/mybox.com\/help\/en\/knowledgebase\/how-to-enable-debug-mode-in-prestashop\/","title":{"rendered":"How to Enable Debug Mode in PrestaShop"},"content":{"rendered":"\n<div class=\"translation-block translation-block-merged\">\n<p class=\"wp-block-paragraph\">Debug mode in PrestaShop displays detailed error messages that can help identify issues with themes, modules, custom code, or server configuration.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">When enabled, PrestaShop will show PHP errors, warnings, and exceptions directly on the page instead of displaying a generic error message.<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\"><strong>Important<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Debug mode should only be enabled temporarily while troubleshooting issues.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Leaving debug mode enabled on a production store may expose sensitive information about your website and server configuration to visitors.<\/p>\n<\/blockquote>\n\n\n\n<div id=\"ez-toc-container\" class=\"ez-toc-v2_0_86 ez-toc-wrap-left counter-hierarchy ez-toc-counter ez-toc-custom ez-toc-container-direction\">\n<div class=\"ez-toc-title-container\">\n<p class=\"ez-toc-title\" style=\"cursor:inherit\">Table of Contents<\/p>\n<span class=\"ez-toc-title-toggle\"><\/span><\/div>\n<nav><ul class='ez-toc-list ez-toc-list-level-1 ' ><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-1\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/how-to-enable-debug-mode-in-prestashop\/#Contents\" >Contents<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-2\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/how-to-enable-debug-mode-in-prestashop\/#PrestaShop_17_and_Newer\" >PrestaShop 1.7 and Newer<\/a><ul class='ez-toc-list-level-3' ><li class='ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-3\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/how-to-enable-debug-mode-in-prestashop\/#Enable_Debug_Mode_from_the_Back_Office\" >Enable Debug Mode from the Back Office<\/a><\/li><\/ul><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-4\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/how-to-enable-debug-mode-in-prestashop\/#Enabling_Debug_Mode_via_FTP\" >Enabling Debug Mode via FTP<\/a><ul class='ez-toc-list-level-3' ><li class='ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-5\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/how-to-enable-debug-mode-in-prestashop\/#Step_1\" >Step 1<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-6\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/how-to-enable-debug-mode-in-prestashop\/#Step_2\" >Step 2<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-7\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/how-to-enable-debug-mode-in-prestashop\/#Step_3\" >Step 3<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-8\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/how-to-enable-debug-mode-in-prestashop\/#Step_4\" >Step 4<\/a><\/li><\/ul><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-9\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/how-to-enable-debug-mode-in-prestashop\/#PrestaShop_153_to_16\" >PrestaShop 1.5.3 to 1.6<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-10\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/how-to-enable-debug-mode-in-prestashop\/#PrestaShop_Earlier_Than_153\" >PrestaShop Earlier Than 1.5.3<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-11\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/how-to-enable-debug-mode-in-prestashop\/#What_Information_Does_Debug_Mode_Display\" >What Information Does Debug Mode Display?<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-12\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/how-to-enable-debug-mode-in-prestashop\/#Disable_Debug_Mode_After_Troubleshooting\" >Disable Debug Mode After Troubleshooting<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-13\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/how-to-enable-debug-mode-in-prestashop\/#Need_Assistance\" >Need Assistance?<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-14\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/how-to-enable-debug-mode-in-prestashop\/#Summary\" >Summary<\/a><\/li><\/ul><\/nav><\/div>\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Contents\"><\/span>Contents<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>PrestaShop 1.7 and Newer<\/li>\n\n\n\n<li>PrestaShop 1.5.3 to 1.6<\/li>\n\n\n\n<li>PrestaShop Earlier Than 1.5.3<\/li>\n\n\n\n<li>Enabling Debug Mode via FTP<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"PrestaShop_17_and_Newer\"><\/span>PrestaShop 1.7 and Newer<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<\/div>\n\n<div id=\"mybox-2091582366\" class=\"mybox-content mybox-entity-placement\"><div class=\"early-access-banner-inpost\">\r\n  <div class=\"banner-left-inpost\">\r\n    <div class=\"icon-box-inpost\">\r\n      <img decoding=\"async\" src=\"https:\/\/mybox.com\/help\/wp-content\/uploads\/2026\/02\/square-info-icon.svg\" alt=\"Info\">\r\n    <\/div>\r\n    <div class=\"text-box-inpost\">\r\n      <span class=\"label-inpost\"><span class=\"translation-block translation-block-banner-text\">Early access<\/span><\/span>\r\n      <h4><span class=\"translation-block translation-block-banner-text\">Still need help?<\/span><\/h4>\r\n      <p><span class=\"translation-block translation-block-banner-text\">Contact our customer service team.<\/span><\/p>\r\n    <\/div>\r\n  <\/div>\r\n\r\n  <div class=\"banner-right-inpost\">\r\n    <a href=\"https:\/\/panel.mybox.com\/helpdesk2\/v\/list\/\" class=\"banner-button-inpost\"><span class=\"translation-block translation-block-banner-text\">Message us<\/span><\/a>\r\n  <\/div>\r\n<\/div><\/div>\n\n<div class=\"translation-block translation-block-merged\"><p class=\"wp-block-paragraph\">If your store is running PrestaShop 1.7 or later, debug mode can be enabled directly from the administration panel.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Enable_Debug_Mode_from_the_Back_Office\"><\/span>Enable Debug Mode from the Back Office<span class=\"ez-toc-section-end\"><\/span><\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Log in to your PrestaShop administration panel.<\/li>\n\n\n\n<li>Navigate to:<\/li>\n<\/ol>\n\n\n\n<pre class=\"wp-block-code\"><code>Configure \u2192 Advanced Parameters \u2192 Performance\n<\/code><\/pre>\n\n\n\n<ol start=\"3\" class=\"wp-block-list\">\n<li>Locate the:<\/li>\n<\/ol>\n\n\n\n<pre class=\"wp-block-code\"><code>Debug Mode\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">section.<\/p>\n\n\n\n<ol start=\"4\" class=\"wp-block-list\">\n<li>Change the setting from:<\/li>\n<\/ol>\n\n\n\n<pre class=\"wp-block-code\"><code>No\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">to:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>Yes\n<\/code><\/pre>\n\n\n\n<ol start=\"5\" class=\"wp-block-list\">\n<li>Click:<\/li>\n<\/ol>\n\n\n\n<pre class=\"wp-block-code\"><code>Save\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Debug mode will be activated immediately.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Enabling_Debug_Mode_via_FTP\"><\/span>Enabling Debug Mode via FTP<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">If you cannot access the PrestaShop administration panel, you can enable debug mode by editing a configuration file.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Step_1\"><\/span>Step 1<span class=\"ez-toc-section-end\"><\/span><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Connect to your hosting account using:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>FTP<\/li>\n\n\n\n<li>SFTP<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Step_2\"><\/span>Step 2<span class=\"ez-toc-section-end\"><\/span><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Open the file:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>config\/defines.inc.php\n<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Step_3\"><\/span>Step 3<span class=\"ez-toc-section-end\"><\/span><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Locate the following line:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>define('_PS_MODE_DEV_', false);\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Replace it with:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>define('_PS_MODE_DEV_', true);\n<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Step_4\"><\/span>Step 4<span class=\"ez-toc-section-end\"><\/span><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Save the file and refresh your store page.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Debug mode should now be active.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"PrestaShop_153_to_16\"><\/span>PrestaShop 1.5.3 to 1.6<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">For PrestaShop versions 1.5.3 through 1.6, the procedure is identical.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Open:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>config\/defines.inc.php\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Find:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>define('_PS_MODE_DEV_', false);\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Change it to:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>define('_PS_MODE_DEV_', true);\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Save the file and reload your website.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"PrestaShop_Earlier_Than_153\"><\/span>PrestaShop Earlier Than 1.5.3<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Older versions of PrestaShop use a different setting.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Open:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>config\/defines.inc.php\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Locate:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>@ini_set('display_errors', 'off');\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Replace it with:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>@ini_set('display_errors', 'on');\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Save the file and refresh your website.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Debug mode should now be enabled.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"What_Information_Does_Debug_Mode_Display\"><\/span>What Information Does Debug Mode Display?<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">When active, debug mode can reveal:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>PHP errors<\/li>\n\n\n\n<li>Fatal errors<\/li>\n\n\n\n<li>Warnings<\/li>\n\n\n\n<li>Notices<\/li>\n\n\n\n<li>Module-related errors<\/li>\n\n\n\n<li>Theme compatibility issues<\/li>\n\n\n\n<li>Database query errors<\/li>\n\n\n\n<li>Missing files or permissions issues<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">This information can be extremely helpful when troubleshooting problems with your store.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Disable_Debug_Mode_After_Troubleshooting\"><\/span>Disable Debug Mode After Troubleshooting<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Once you have identified and resolved the issue, disable debug mode again.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">For newer versions:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>Configure \u2192 Advanced Parameters \u2192 Performance\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Set:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>Debug Mode = No\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">For manual activation, revert the configuration file change back to:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>define('_PS_MODE_DEV_', false);\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">or<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>@ini_set('display_errors', 'off');\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">depending on your PrestaShop version.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Need_Assistance\"><\/span>Need Assistance?<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">If you are unable to enable debug mode or need help interpreting the displayed errors, contact the mybox support team through the:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>24\/7 Helpdesk\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Include:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Your domain name.<\/li>\n\n\n\n<li>Your PrestaShop version.<\/li>\n\n\n\n<li>A screenshot or copy of the error message.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">This will help speed up the troubleshooting process.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Summary\"><\/span>Summary<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Debug mode is a useful troubleshooting tool that displays detailed error information for your PrestaShop store.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Depending on your PrestaShop version, you can enable it:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>From the administration panel.<\/li>\n\n\n\n<li>By editing the <code>config\/defines.inc.php<\/code> file.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Remember to disable debug mode after troubleshooting is complete to prevent sensitive information from being displayed publicly.<\/p>\n<\/div>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"template":"","format":"standard","manualknowledgebasecat":[58],"manual_kb_tag":[4822,4823,1098,4258,4259,4264,4818,4819,4820,4821],"class_list":["post-9782","manual_kb","type-manual_kb","status-publish","format-standard","hentry","manualknowledgebasecat-web-applications-cms","manual_kb_tag-advanced-parameters","manual_kb_tag-performance-settings","manual_kb_tag-error-messages","manual_kb_tag-enable-debug-mode","manual_kb_tag-disable-debug-mode","manual_kb_tag-display-errors","manual_kb_tag-prestashop-debug-mode","manual_kb_tag-debugging-prestashop","manual_kb_tag-troubleshooting-prestashop","manual_kb_tag-back-office"],"_links":{"self":[{"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/manual_kb\/9782","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/manual_kb"}],"about":[{"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/types\/manual_kb"}],"author":[{"embeddable":true,"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/users\/1"}],"version-history":[{"count":2,"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/manual_kb\/9782\/revisions"}],"predecessor-version":[{"id":9791,"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/manual_kb\/9782\/revisions\/9791"}],"wp:attachment":[{"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/media?parent=9782"}],"wp:term":[{"taxonomy":"manualknowledgebasecat","embeddable":true,"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/manualknowledgebasecat?post=9782"},{"taxonomy":"manual_kb_tag","embeddable":true,"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/manual_kb_tag?post=9782"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}