TiddlyWiki5/editions/tw5.com/tiddlers/features/SafeMode.tid

created: 20140419082845576
modified: 20160610082458079
tags: Features
title: SafeMode
type: text/vnd.tiddlywiki

! Introduction

Safe mode provides a way to disabling most customisations in TiddlyWiki. This is useful because if TiddlyWiki is customised incorrectly it can be rendered inoperable. A particular issue is that some customisations break when upgrading to a newer core version of TiddlyWiki (especially during the beta).

! Enabling Safe Mode

Safe mode is enabled in the browser by starting TiddlyWiki with the URL hash set to the string `#:safe`. For example:

https://tiddlywiki.com/#:safe

! How Safe Mode Works

Safe mode triggers two changes:

* All plugins are temporarily disabled. You can use the [[control panel|$:/ControlPanel]] {{$:/core/images/options-button}} to disable individual plugins
* Any tiddlers that override shadow tiddlers are renamed to give them the prefix `SAFE: `, thus restoring the underlying shadow tiddler
* Certain configuration options are ignored, and the default settings used instead:
** WikiParserRuleConfiguration

A report tiddler is displayed that allows you to inspect the tiddlers that were renamed.