This page is part of a static HTML representation of the TiddlyWiki at


 13th November 2023 at 9:33am


The browse widget displays an HTML file browser button that allows the user to choose one or more files to import. It sends a WidgetMessage: tm-import-tiddlers carrying a JSON representation of the tiddlers imported from the files up through its parents. This message is usually handled by the NavigatorWidget which adds the tiddlers to the store and updates the story to display them.

Content and Attributes

The content of the $BrowseWidget widget is ignored.

multipleSet to "multiple" to select multiple file upload
deserializerIntroduced in v5.1.15 Optional name of deserializer to be used (by default the deserializer is derived from the file extension or type)
tooltipOptional tooltip text
acceptIntroduced in v5.1.23 Optional comma delimited list of file accepted extensions and/or MIME types
messageOptional override of widget message to be generated. The files will be passed in the JavaScript object
paramOptional parameter to be passed with the custom message
data-*New in v5.3.2 Optional data attributes to be assigned to the HTML element
style.*New in v5.3.2 Optional CSS properties to be assigned to the HTML element

On iPhone/iPad choosing the multiple option will remove the ability to take photographs/videos directly into TiddlyWiki.



renders as: