Use Safe Mode to troubleshoot issues with themes and plugins

Discourse has a “JavaScript Safe Modeany user can use to isolate the root cause of a JavaScript issue caused by plugins, themes or theme components.

To access safe mode go to:

http://your-site-name/safe-mode for example this is the safe mode for meta:

https://meta.discourse.org/safe-mode

To exit safe mode simply close your browser tab

When entering safe mode you can select between:

  • Disable all themes and theme-components

  • Disable unofficial plugins

  • Disable all plugins

By default all 3 options are selected, but you can enter safe mode multiple times to isolate the culprit breaking your site.

Safe mode currently only disables the JavaScript portions of plugins, to disable the server side portion you must rebuild your container with the plugin commented out. Historically the majority of breakages were in the JavaScript portions of plugins.

66 Likes