title: $:/plugins/tiddlywiki/browser-storage/settings
caption: Browser Storage
tags: $:/tags/ControlPanel/SettingsTab

! Disable

You can disable the browser storage plugin:

<$checkbox tiddler="$:/config/BrowserStorage/Enabled" field="text" checked="yes" unchecked="no" default="yes"> Use browser local storage</$checkbox>

! Clear

Click this button to clear browser storage and disable its use:

<$button message="tm-clear-browser-storage">Clear browser storage</$button>

! Save Filter

This filter determines which tiddlers will be saved to local storage.

* `[prefix[$:/state/]] -[prefix[$:/state/popup/]]` - the default value. Save state tiddlers except popup state tiddlers, thus preserving selected tabs and the open/closed status of table of contents entries. Any other tiddlers created or changed will be lost after reloading the page.
* `[all[]]` - attempt to save all changed tiddlers. This means even popup state tiddlers and temporary tiddlers will be saved.
* `[all[]] -[prefix[$:/state/popup/]] -[prefix[$:/temp/]] -[prefix[$:/HistoryList]]` - save all tiddlers except popup state tiddlers, temp tiddlers and the history list.

|tc-table-no-border|k
|<$link to="$:/config/BrowserStorage/SaveFilter">Browser Storage Save Filter</$link> |<$edit-text tiddler="$:/config/BrowserStorage/SaveFilter" default="" tag="input"/> |

! Custom Quota Exceeded Alert

This setting allows a custom alert message to be displayed when an attempt to store a tiddler fails due to the storage quota being exceeded:

|tc-table-no-border|k
|<$link to="$:/config/BrowserStorage/QuotaExceededAlert">Quota Exceeded Alert</$link> |<$edit-text tiddler="$:/config/BrowserStorage/QuotaExceededAlert" default="" tag="input"/> |

! Prevent browser from evicting local storage

Permission for local storage persistence: ''{{$:/state/browser/storage/persisted}}''

The first time a tiddler is saved to local storage a request will be made to prevent automatic eviction of local storage for this site. This means the data will not be cleared unless the user manually clears it.

Old browsers may not support this feature. New browsers might not support the feature if the wiki is hosted on a non-localhost unencrypted http connection.

Some browsers will explicitly prompt the user for permission. Other browsers may automatically grant or deny the request based on site usage or based on whether the site is bookmarked.

! Startup Log

The tiddler $:/temp/BrowserStorage/Log contains a log of the tiddlers that were loaded from local storage at startup:

<<list-links "[enlist{$:/temp/BrowserStorage/Log}sort[]]">>
