Title: Troubleshooting Author: Marius L. J. Published: September 21, 2024 Last modified: January 1, 2026 --- Search plugins ![](https://s.w.org/plugins/geopattern-icon/troubleshooting.svg) # Troubleshooting By [Marius L. J.](https://profiles.wordpress.org/clorith/) [Download](https://downloads.wordpress.org/plugin/troubleshooting.1.0.2.zip) * [Details](https://li.wordpress.org/plugins/troubleshooting/#description) * [Reviews](https://li.wordpress.org/plugins/troubleshooting/#reviews) * [Development](https://li.wordpress.org/plugins/troubleshooting/#developers) [Support](https://wordpress.org/support/plugin/troubleshooting/) ## Description Troubleshooting Mode was initially a feature introduced via the Health Check plugin, and is now available as a standalone plugin. The most common, and reliable, means of troubleshooting a website using WordPress, is by first disabling all plugins, and using one of the default themes that come with the software. The best way to do this, is by the use of a staging website, but not all website hosting providers have this feature, or it may not be part of the plan you are currently on. Troubleshooting Mode will do its best to allow a site maintainer to disable plugins, and switch themes, without affecting regular visitors to your website. ## FAQ ### How can I disable Troubleshooting Mode? Troubleshooting Mode has various ways to be disabled, depending on your situation. Normally you would either click the “Disable Troubleshooting Mode” button within your admin dashboard, or from the “Troubleshooting Mode” menu item in the admin bar. If you are unable to access your admin dashboard, or your admin bar for any reason, either signing out from your website, clearing all cookies for your website, or closing all your browser windows will also remove the cookies used to declare your current account as being in Troubleshooting Mode. ### My website looks broken after using Troubleshooting Mode! Unfortunately, despite our best efforts, some caching solutions are either so complex, or so aggressive, that they do not respect Troubleshooting Mode’s directives to not cache any content. It is recommended to clear your caches after completing your troubleshooting, this can usually be done from your caching plugin’s settings, or by disabling and re- enabling the caching plugin. Note that your hosting provider may also have a dedicated button to clear its caching from their own control panel, if this is offered to you. ### Can I contribute to this plugin? Yes, the plugin is open source and available on the [WordPress/site-health-troubleshooting GitHub repository](https://github.com/wordpress/site-health-troubleshooting), and we welcome all types of contributions! ## Reviews There are no reviews for this plugin. ## Contributors & Developers “Troubleshooting” is open source software. The following people have contributed to this plugin. Contributors * [ Marius L. J. ](https://profiles.wordpress.org/clorith/) “Troubleshooting” has been translated into 1 locale. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/troubleshooting/contributors) for their contributions. [Translate “Troubleshooting” into your language.](https://translate.wordpress.org/projects/wp-plugins/troubleshooting) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/troubleshooting/), check out the [SVN repository](https://plugins.svn.wordpress.org/troubleshooting/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/troubleshooting/) by [RSS](https://plugins.trac.wordpress.org/log/troubleshooting/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.0.2 (2025-12-30) * Fixed: Translation warnings when using WordPress 6.7 or later. * Troubleshooting Mode: Add Twenty Twenty Five to the list of default themes. #### 1.0.1 (2024-10-02) * Fixed: Remove some strict typecasting on filters where plugins may return values WordPress core does not expect, to avoid causing fatal errors. * Fixed: Removed some more strict typecasting causing issues when switching between a block and non-block theme in troubleshooting mode. * Improvement: Made the plugin attempt to use symlinks instead of copying files when setting up the mu-plugin. = 1.0.0 (2024-09-21) * Initial release ## Community plugin This plugin is developed and supported by a community. [Contribute to this plugin](https://github.com/wordpress/site-health-troubleshooting) ## Meta * Version **1.0.2** * Last updated **4 months ago** * Active installations **100+** * WordPress version ** 5.8 or higher ** * Tested up to **6.9.4** * PHP version ** 7.1 or higher ** * Languages * [English (US)](https://wordpress.org/plugins/troubleshooting/) and [Russian](https://ru.wordpress.org/plugins/troubleshooting/). * [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/troubleshooting) * Tags * [health check](https://li.wordpress.org/plugins/tags/health-check/)[site health](https://li.wordpress.org/plugins/tags/site-health/) * [Advanced View](https://li.wordpress.org/plugins/troubleshooting/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/troubleshooting/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/troubleshooting/reviews/) ## Contributors * [ Marius L. J. ](https://profiles.wordpress.org/clorith/) ## Support Issues resolved in last two months: 0 out of 1 [View support forum](https://wordpress.org/support/plugin/troubleshooting/)