{"id":18391,"date":"2026-09-29T23:17:28","date_gmt":"2026-09-29T20:17:28","guid":{"rendered":"https:\/\/www.hyyat.com\/knowledgebase\/debug-wordpress-wp-toolkit\/"},"modified":"2026-09-29T23:17:28","modified_gmt":"2026-09-29T20:17:28","password":"","slug":"debug-wordpress-wp-toolkit","status":"publish","type":"docs","link":"https:\/\/www.hyyat.com\/en\/knowledgebase\/debug-wordpress-wp-toolkit\/","title":{"rendered":"How to Debug WordPress with WP Toolkit in cPanel"},"content":{"rendered":"<div class=\"hy-tldr\" style=\"background:#f6f7fb;border-left:4px solid #d83954;border-radius:10px;padding:14px 18px;margin:0 0 20px;line-height:1.8\"><strong>In short:<\/strong> WordPress Toolkit in cPanel makes debugging easier: turn on Debugging and choose options such as WP_DEBUG_LOG to write errors to wp-content\/debug.log, deactivate plugins one by one to find the one causing the problem, turn on maintenance mode while you fix it, or restore an earlier backup in one click.<\/div>\n<p>WordPress usually just works, but errors in a plugin, theme or custom code can cause unexpected behavior. WordPress has built-in debugging tools, but they are off by default and cannot be set from the dashboard. WordPress Toolkit in cPanel gives you a simple interface to:<\/p>\n<ul>\n<li>Turn on and configure WordPress debugging.<\/li>\n<li>Find faulty plugins.<\/li>\n<li>Turn on and customize maintenance mode.<\/li>\n<li>Restore a backup.<\/li>\n<\/ul>\n<h2>Turn on and configure debugging<\/h2>\n<p>Debug mode makes WordPress log the errors and warnings produced by PHP code. It is usually off because it uses server resources and can reveal internal information, so keep the logs private. To turn it on, select your site in WordPress Toolkit and click the <strong>Debugging<\/strong> switch in the Tools section.<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/www.hyyat.com\/zasogooh\/2020\/12\/2020-12-04_22-17-44-1.jpg\" alt=\"Debugging switch in WordPress Toolkit\" \/><\/p>\n<p>By default, errors are printed on the site&#8217;s pages. Click the settings icon next to the switch to change this.<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/www.hyyat.com\/zasogooh\/2020\/12\/2020-12-04_22-22-46.jpg\" alt=\"Debugging options\" \/><\/p>\n<ul>\n<li><strong>WP_DEBUG<\/strong> turns debug mode on or off. Keep it off during normal operation.<\/li>\n<li><strong>WP_DEBUG_LOG<\/strong> writes errors to a file named debug.log in the site&#8217;s wp-content folder.<\/li>\n<li><strong>WP_DEBUG_DISPLAY<\/strong> controls whether errors are shown on the pages. Useful on a test site; on a live site, turn it off and use the log instead.<\/li>\n<li><strong>SCRIPT_DEBUG<\/strong> makes WordPress use the non-minified CSS and JavaScript files, which helps find front-end errors.<\/li>\n<li><strong>SAVEQUERIES<\/strong> saves database queries for inspection. It can slow the site down a lot, so turn it off when you finish.<\/li>\n<\/ul>\n<p>Click <strong>OK<\/strong> to save. If you turned on WP_DEBUG_LOG, open <strong>File Manager<\/strong>, go to the site&#8217;s wp-content folder and open debug.log to read the errors.<\/p>\n<h2>Find a faulty plugin<\/h2>\n<p>Reading PHP logs can be hard for non-developers. A simpler way is to deactivate plugins one by one until the problem disappears; the last plugin you deactivated is the cause. Select your site in WordPress Toolkit and open the <strong>Plugins<\/strong> tab.<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/www.hyyat.com\/zasogooh\/2020\/12\/2020-12-04_22-28-10-1.jpg\" alt=\"Plugins tab in WordPress Toolkit\" \/><\/p>\n<p>To deactivate or remove a plugin from all WordPress sites in your cPanel account, open the global <strong>Plugins<\/strong> tab, select the plugin and click the right button.<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/www.hyyat.com\/zasogooh\/2020\/12\/2020-12-04_22-36-44.jpg\" alt=\"Global plugins list\" \/><\/p>\n<h2>Turn on maintenance mode<\/h2>\n<p>Debug mode is meant for test sites. If you find an error on a live site that affects visitors, combine it with maintenance mode, which shows a simple page telling visitors the site is being worked on. WordPress Toolkit includes an improved maintenance page with a customizable text and countdown. Select your site and click the maintenance mode switch.<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/www.hyyat.com\/zasogooh\/2020\/12\/2020-12-04_22-45-59.jpg\" alt=\"Maintenance mode switch\" \/><\/p>\n<p>To customize the page, click the maintenance mode icon, make your changes and check them with the <strong>Preview<\/strong> button.<\/p>\n<h2>Restore a backup<\/h2>\n<p>The fastest fix is often to restore a backup taken before the error appeared. Open <strong>Backup \/ Restore<\/strong> for your site in WordPress Toolkit.<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/www.hyyat.com\/zasogooh\/2020\/12\/2020-12-04_22-54-34.jpg\" alt=\"Backup \/ Restore\" \/><\/p>\n<p>Choose a recent backup from the list and click <strong>Restore<\/strong>.<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/www.hyyat.com\/zasogooh\/2020\/12\/2020-12-04_22-56-47.jpg\" alt=\"Restore a backup\" \/><\/p>\n<p><strong>Note:<\/strong> restoring removes all changes made after the backup was taken, so create a new backup first.<\/p>\n<p class=\"hy-svc-link\" style=\"background:#fff5f7;border-left:4px solid #d83954;border-radius:10px;padding:14px 18px;margin:20px 0;line-height:1.8\"><strong>Related service:<\/strong> <a href=\"https:\/\/www.hyyat.com\/en\/wordpress-hosting\/\">Hyyat Host WordPress hosting<\/a> includes WordPress Toolkit, automatic backups and 24\/7 support.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>In short: WordPress Toolkit in cPanel makes debugging easier: turn on Debugging and choose options such as WP_DEBUG_LOG to write errors to wp-content\/debug.log, deactivate plugins one by one to find the one causing the problem, turn on maintenance mode while you fix it, or restore an earlier backup in one click. WordPress usually just works, [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"inline_featured_image":false,"_templately_pack_id":"","_templately_imported_at":"","_templately_source":"","_templately_import_session_id":"","footnotes":""},"doc_category":[2747],"doc_tag":[],"class_list":["post-18391","docs","type-docs","status-publish","hentry","doc_category-wordpress-explanations"],"year_month":"2026-10","word_count":533,"total_views":"4","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"name":"admin","author_nicename":"admin","author_url":"https:\/\/www.hyyat.com\/en\/author\/admin\/"},"doc_category_info":[{"term_name":"WordPress explanations","term_url":"https:\/\/www.hyyat.com\/en\/kb\/wordpress-explanations\/"}],"doc_tag_info":[],"knowledge_base_info":[],"knowledge_base_slug":[],"_links":{"self":[{"href":"https:\/\/www.hyyat.com\/en\/wp-json\/wp\/v2\/docs\/18391","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.hyyat.com\/en\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/www.hyyat.com\/en\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/www.hyyat.com\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.hyyat.com\/en\/wp-json\/wp\/v2\/comments?post=18391"}],"version-history":[{"count":0,"href":"https:\/\/www.hyyat.com\/en\/wp-json\/wp\/v2\/docs\/18391\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.hyyat.com\/en\/wp-json\/wp\/v2\/media?parent=18391"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/www.hyyat.com\/en\/wp-json\/wp\/v2\/doc_category?post=18391"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www.hyyat.com\/en\/wp-json\/wp\/v2\/doc_tag?post=18391"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}