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 disable 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.

62 Likes
⚠ Broken upgrade - forum down, unhelpful error 🚫
Admin Plugin page is blank - Error: There is no route named adminPlugins.index
Content of messages not showing up
Change in Forum layout makes writing and editing incredibly difficult
"About" pages crashing our Discourse
Uncaught Errors
Topic Preview Broken due to Google PageSpeed Module
502 and then empty forum after `./launcher rebuild app`
Upgraded last night and login button no longer works
Messaging drop down menu not working
Repeated content and infinite loop
The composer needs to be more friendly to iPad Mini
Manually Clear DistributedCache
Browser too old message when "compatibility mode" is forced in IE 11
Admin Plugin page is blank - Error: There is no route named adminPlugins.index
My site just broke after restarting server
After Recent Upgrade to 1.08? beta - No forum shows
Blank topics after import?
Problems clicking topic links in IE11
Double but offset lines in edit box
A "safe mode" to easily disable all third party plugins
Website looks different on different browsers
How to disable a component without access to site?
Cannot create new topics (already disabled plugins)
Improved Bookmarks with Reminders
Setting up a private category
Scrolling posts "jumps" back up when reaching end
How to increase site speed
Upgrade from within China fails due to git issues
Disable plugins without restarting?
Updating / Rebuilding Discourse to latest version irreversibly breaks website
A "safe mode" to easily disable all third party plugins
Discourse and Uncaught ReferenceError: ClipboardJS is not defined
Beginner's guide to using Discourse Themes
Global notice doesn’t show
Unable to expand profile
404 error on base url / frontpage
Disable plugin without downtime?
Like button does not work on archived topics
Recent update broke my top navigation bar
Mobile Header expanding after tapping hamburger menu
Discourse 2.3.0.beta10 Release Notes
Lightbox not showing up on uploaded images after update
Vimeo onebox not working
Pasting tables from spreadsheets no longer working after 2.3 upgrade
Contains_dtoc in Grey Amber theme header
Site fails to load with js errors
No content displayed on front category page after upgrade
Notifications are acting strange
Occasional page loads with no post content due to plugins
Discourse 2.5.0.beta2 Release Notes
LDAP Setup for Discourse
Unable to add/edit tags
Unable to add/edit tags
Category unlike any other category
Unable to save wiki update
Infinite scroll not working in "Latest" on Mobile
Disappearing posts in 2.1.0.beta2
Post content not showing up
In-post links to topics - no longer update to the initial posts title
MacOs users on old version can´t read posts
Edit CSS/HTML of custom theme not appearing
Issue with menu, admin
Excerpts truncating at 50 characters
How to change default Discourse theme via CLI?
Rtl direction is broken in quotes
Mentions reported wrongly as replies in notifications list
After recoverying a Backup file on new "On-premise" VM - Site no longer works
Problem with creating Topic with external_id
Bad JS customizations - how to fix in the backend?
Wizard plugin link isn't working
User Notes plugin is breaking my site
Send Invites button should not be visible if local logins are disabled
Fields overlay text in login
No Profile Header or User Card Background in /preference/profile?
Blank page after theme installation
Fields overlay text in login
Topic-footer buttons are disappearing
Blank pages, 500 errors and no logs
[2.1.0b6] New topic button is moving behind burger on click
Problem with displaying personal messages in Dark
Google, Twitter and Facebook Logins not working due to ad blocker
Can't See Posts When Logged Out
Back to topic list scroll position not smooth
After latest admin/upgrade my Admin dashboard won't load
My install was broken because I upgraded but did not upgrade plugins
Bulk edit icon not showing?
Quoting is not working anymore
Some user see a blank page when opening a topic
Rtl direction is broken in quotes
Admin Trouble Creating a Category
Browser Back Button issue
Issue when zooming large image in lightbox on mobile
Topic mismatch troubleshooting
Edit icon not activating after edits
I don't see the staff wrench on posts
Forum does not work for users on iOS
Broken instance after updating to 2.9.0.beta2
Discourse OpenID Connect
Category autocomplete stopped working on our site?
A topic doesn't open with recent upgrade due to a plugin
UI not loading after git pull update
Gui for querying category of solved or unsolved topics
Image displayed incorrectly on Mobile due to theme settings
Preview of post not loading because force https was not set
Beginner's guide to using Discourse Themes
After updating to "2.9.0.beta1", the number of clicks on the image URL is not counted
Reordering Categories Produces Error 422
Limit on Number of Child Categories?
Password reset landing page not loading because of cloudflare rocketloader
Password reset landing page not loading because of cloudflare rocketloader
Password reset landing page not loading because of cloudflare rocketloader
Log out does not work
Invites not populating Invite URL
Back to topic list scroll position not smooth
"Something went wrong" when liking posts using hearts
Issue in user summary
Lightbox for images comes by default?
Updated discourse and now site fails to display
Before there was an icon in my text box where I could send images, gifs and videos
Updated discourse and now site fails to display
Having an issue with images' width getting cut off on desktop
Issue with the page title in Arabic?
Get started with Theme Creator and the Theme CLI
Images in topic appearing in negative
Something has gone wrong. Perhaps this topic was closed or deleted while you were looking at it?
Latest update broke my forum
Clicking on a category doesn't filter the right topics
Registration modal/popup not showing up for private instance
Iframes Not Working
Nothing happens when i try to publish a topic
500 error on category view mobile due to knowledge base plugin
Html tags are explicit after latest update
Before there was an icon in my text box where I could send images, gifs and videos
Topics tagged with `info` have strange appearance
Missing scroll bar slider, in Finnish Localization
Server errors in 2.5.0.beta3
Undefined column 'boomarks.post_id' after update
Multi-site upgrade leaves _some_ sites unavailable
Logins redirects to missing notifications page
Sharing long strings of text without spaces (in titles) or URLs causes stretching of the notification window
Plugin admin section
Discourse broken after upgrade
Topic Will Close A Few Seconds After The Last Reply
Can't add tags while editing a topic
Can't add tags while editing a topic
Issues with index page infinite scrolling?
How might we better structure #howto?
Plugin page not loading unless I hard refresh (Chrome)
Plugin page not loading unless I hard refresh (Chrome)
Column bookmarks.topic_id does not exist
Better error pages?
Featured Tiles
Redis Problems? (Forum broken after upgrade)
Hashtags with numbers in parentheses appearing everywhere on Discourse site
After updating to 2.8.0.beta8, nothing shows as "read" anymore
After updating to 2.8.0.beta8, nothing shows as "read" anymore
Breaking Mobile view check after Discourse update to 2.5.0.beta7
Dashboard empty since upgradeto 2.5.0
Can’t create new category
Login form missing entirely from Discourse instance
Mobile devices cannot display the interface correctly
Category link failed after updating today
Double but offset lines in edit box
Weird Formatting Bug in old Microsoft Edge
Blank website after update
Content won't load after update
Category Icons
Category link failed after updating today
Error 500 on category page and homepage after upgrade to 2.6
Mouse click is not working in my forum after recent update
Screen black out bug on modal
Social share components do not appear
Admin panel does not work
Totally blank upgrades page
Accidentally overwrote application.hbs || Enter safe mode
My Discourse site is not loading due to misconfigured CSP
Latest beta update (2.7.0b7) gone wrong
Some topic category boxes are missing
Need help reverting forums. I made a mistake
Can not access Discourse - blank page
Display issue in the "hide details" element
Topic replies are not displaying in chronological order?
Site broken after update
The "Save Changes" button is very low on my user preferences interface page
Uploads timing out or very slow
Problems when logging in as admin
I made an update, the site is gone
Problems when logging in as admin
Scroll jank when scrolling up
Phantom signups (two users with the same account after migration)
Composer overflows when open
Composer overflows when open
Homepage (sub)category display - lots of whitespace
Category Image Formatting
Homepage (sub)category display - lots of whitespace
Username autocompletion not working with special characters?
500 Error when loading a specific topic
Update problem help pls
Scroll jank when scrolling up
Scroll jank when scrolling up
Sub-category not showing up in Categories with Featured Topics view + not Arranged in order on Category page
Restarted VM; now `/admin/upgrade` page fails to load, JS requests fail, some avatar images 404ing
Bug on topic interface after an update || Resolved
Scroll jank when scrolling up
Upgrading from 2.9.0.beta8 broke the site, unrecoverable
Site broken after update
Tags are not working due to multilingual plugin
Safe-mode returns ["BAD CSRF"] with reverse proxy
MacOS Firefox image upload error
MacOS Firefox image upload error
504 Gateway Timeout for some reports
How do you add another person to a private message when it's already sent?
Repeated content and infinite loop
Trust level 1 users cannot Invite
Error: Something went wrong - "Error while processing route: discovery.categories"
Error: Something went wrong - "Error while processing route: discovery.categories"
Error: Something went wrong - "Error while processing route: discovery.categories"
Loading groups gives internal server error
UI not rendering in Chrome/Firefox due to CloudFlare rocket loader
"Reply" button appears even on closed topics when logged out
One admin restarted the forum while another was updating. How to fix
Error when going to the plugins admin tab while in safe-mode
Private Message Can't Be Reached with private messaging disabled
Empty category about topic is crashing my browser tab
Double new topic banner
[2.7.11] tags notifications dont work anymore for regular profil
My Discourse Forum can't display images
Display issue in the "hide details" element
User-defined theme switcher disappears on admin pages
Firefox experiences Network Protocol Violation on Discourse based Websites
Upgrade page empty
Custom CSS/HTML editor panel access button disappeared
Upgrade page empty
Can I view my own topic that is awaiting moderation?
Problem with displaying personal messages in Dark
Can't pin/unpin topic from the title
Can't rebuild due to theme errors
Can't rebuild due to theme errors
Application crash due to invalid imports
Topics preview gone - upgrade from 2.6 to.2.9
Width of page causes an autoscroll to the top of the page when accessing serach/user/hamburger comboboxes (chrome only)
Width of page causes an autoscroll to the top of the page when accessing serach/user/hamburger comboboxes (chrome only)
Jittery scrolling behavior
Search Bar pops up when adding new topic or replying
Search Bar pops up when adding new topic or replying
Spurious "Draft is being edited in other window" errors
Scrolling posts "jumps" back up when reaching end
Updated discourse and now my spacing is off
Screen jumping around on mobile
Upcoming events shows 500 server error
Mixcloud Embeds have stopped working
"Watched words" review queue seems broken
Screen jumping around on mobile
How to fix problem with CSP
Screen jumping around on mobile
Frontend on Prod Site Down -- Ember/Test error
Error: Can't access property "registerAsyncHelper"
Hamburger menu not showing on mobile?
Pasting a Youtube playlist link in the title doesn't fill the title and post content
Moderators not displaying on About page
Fast edit doesn't work on content with certain characters
Lightbox not working on Discourse
Lightbox not working on Discourse
Lightbox not working on Discourse
Upcoming events shows 500 server error
"Watched words" review queue seems broken
Thumbs up, twice
Category image upload stops at 0%
Lightbox not working on Discourse
Javascript error if emoji_autocomplete_min_chars setting > 0 for each character typed after a colon in the composer
Horizontal loading slider
Iframes Not Working
Our site is suddenly not loading
Polls broken after update
Polls broken after update
Polls broken after update
Categories: Security options don't get changed
Very minor issue: on the topics list, the new messages indicator can be on a new line by itself
Little crack when sliding on Iphone
User preference persists through Safe Mode
New topic mobile CSS corruption?
User preference persists through Safe Mode
User preference persists through Safe Mode
Updated discourse and now my spacing is off
User preference persists through Safe Mode
Updating / Rebuilding Discourse to latest version irreversibly breaks website
Updating / Rebuilding Discourse to latest version irreversibly breaks website
Updated discourse and now my spacing is off
Hamburger menu not showing on mobile?
Hide who's replying to this topic
Forum Completely Broken 2.8.5
Mobile view editor cog dropdown issue
How many category moderators are shown on about page?
How many category moderators are shown on about page?
"Posts may not display correctly because" seeing this error in new discourse installation
Topics preview gone - upgrade from 2.6 to.2.9
The notification bar could not load
Discourse 1.9.0.beta15 Release Notes
The notification bar could not load
Trading buttons: Buy, Sell, Exchange
Watched words also applied to staff?
Category logo image overlaid by text after recent update
Category logo image overlaid by text after recent update
Discourse Failing to Work
Post Preview not working because of events plugin
Site not loading and breaking after doing upgrade from admin UI due to theme errors
The "Hide Details" feature doesn't show up correctly in the preview window
The "Hide Details" feature doesn't show up correctly in the preview window
The "Hide Details" feature doesn't show up correctly in the preview window
The "Hide Details" feature doesn't show up correctly in the preview window
The "Hide Details" feature doesn't show up correctly in the preview window
Category missing (only showing posts per month) when not logged in
Post delay - 2 post
Personal Message Bubbles
Giant flashing edge/cursor on Latest view
Images being cropped on mobile
Non-staff users are missing link to Messages in UI
Unable to create categories - No creation button for admin or moderator
Unable to create categories - No creation button for admin or moderator
TypeError: Cannot read property 'id' of undefined
Text editor is not working in Firefox 78?
Prevent anons from downloading files incompatible with CDN
What on earth is causing this?
Composer does not work properly when repling on Firefox
Composer does not work properly when repling on Firefox
"all categories" button and "open draft" button outline is weird
Users cannot check discourse
Topic links from the “latest” topics list don’t always scroll to the last read post
IP Lookup UI is broken
IP Lookup UI is broken
Post Preview not working because of events plugin
Unable to reply on original topic
The composer gets stuck under the header if dragged too far up
Topic links from the “latest” topics list don’t always scroll to the last read post
"Review" disappeared from top-level menu
"Review" disappeared from top-level menu
My forum stuck on blank page without content
Pop up - how to css?
Post Preview not working because of events plugin
Latest update gives blank screen on mobile
Latest update gives blank screen on mobile
Latest update gives blank screen on mobile
Latest update gives blank screen on mobile
Mobile view editor cog dropdown issue
The composer gets stuck under the header if dragged too far up
Server reboot necessitates disco container reboot
Post Preview not working because of events plugin
Plugins not visible on Dashboard
Kanban Board
Published page not visible?
After restoring a backup, discourse is 'loading...' and broke
Global notice doesn’t show
TypeError: r is not iterable
Writing a Good Bug Report
All groups are not anymore displayed in group page
While loading a new component on the site, the site is down
While loading a new component on the site, the site is down
Discobot didn't recognize link in tutorial
No Gear Icon Menu for Moderator [iPad]
No Gear Icon Menu for Moderator [iPad]
Embedded Youtube videos sometimes need to be clicked twice to start playing
Code Highlighting with Escaped Quotes
Why is the Sidebar Collapse missing on my site?
Discourse keeps refreshing images and content
Popular Topics | By Default Today
Inserting Javascript yields 403 error
Topic hangs on mobile
Search results page displays topics title that I cannot click
Search results page displays topics title that I cannot click
Converted topic posts to message can not convert back to topic
Invited by
Bulk Append Tags Not Working
Bulk Append Tags Not Working
Links in Logs have a blank href
Our discourse overload because of a custom plugin. Please help me
Our discourse overload because of a custom plugin. Please help me
Issues with site on Linode because domain’s registration had expired
Text glitch on my forum
About the user fields arrangement problem
Deprecation warnings are causing an exception
No Profile Header or User Card Background in /preference/profile?
No Profile Header or User Card Background in /preference/profile?
Undefined column 'boomarks.post_id' after update
Can't close user notes modal due to deprecated guest gate plugin
Attempted to upgrade and I think I messed something up
Clipboard copy from theme text editor only copies about a one and half lines of text
Not able to enter info on /admin/plugins/rss_polling page [ad-blocker]
Account creation not working with discourse_encrypt
Notification issues
Discourse not available
Data explorer group report - parameter bug
"Like this post" not available for some categories
Incompatibility between Cakeday,Data-Explorer and Animated Avatar plugins
Clipboard copy from theme text editor only copies about a one and half lines of text
Search no longer works after 3.1.0.beta1 update
Search no longer works after 3.1.0.beta1 update
Search no longer works after 3.1.0.beta1 update
After update, site won't come up
After update, site won't come up
After update, site won't come up
TL… is non-functional categoryname for hashtag
Tag section and All Tags link not visible on the sidebar unless a default tag is set
Hosted site stuck on loading page (colored dots) (01/18/2023 8:05 AM Eastern)
Discourse not launching after upgrade
Discourse not launching after upgrade
Discourse not launching after upgrade
Streamable - whole file is downloaded on mobile version
Streamable - whole file is downloaded on mobile version
Drag'n drop cause crash browser tab
Reports is not loading
Discourse now stops loading at login dialog when viewed with any browser
Error: Users can't make new accounts
Repeated content and infinite loop
Assign plugin: Note not visible
Only loading HEAD after upgrading docker, due to Babble plugin
Made some changes I cannot revert
Using Cloudflare for HTTPS, empty preview pane in edit page
Custom Hamburger Menu Links
Avatar settings not visible with SSO
Emoticon button not working anymore (because of babble plugin)
Stable broken due to discourse-spoiler-alert
How to disable a plugin when admin plugin page is not loading
New topic and reply not working
Front page of discourse missing content