This version is out of date, covering development from v5.0.0 to v5.12.2. It is maintained here only for inbound reference links from elsewhere.

Jump to the current version of aTbRef.

Tinderbox Icon

Hoist - Unhoist - Expand View - Up Arrow


In Outline, Chart or Treemap views, Hoist focuses the view on the currently selected note and its descendants. The hoist command is not available in map view.

A hoisted view is subtly like a map except that in a map you can't access the contents of the parent container. Conversely, in a hoisted view you can see/edit the container but you can't add siblings to it; this is because the view's scope for adding/removing notes restricted entirely within the root notes descendants.

Thus, in a hoisted view, siblings can't be added to to the root (top) note, only children/descendants.

To navigate from a 'hoisted' view you can move scope:

For reference, Maps have the same 'up' choices but slightly different 'down' choices:

Expand View

The Expand View function moves the current view 'up' one level. It is the same effect as clicking once on a view windows 'Up Arrow' icon (greyed out at top level). Although there is no menu item, the opposite keyboard short cut to this method achieves a 'drill down' one level if the current note is a container.

'Up' Arrow

Actually a left-pointing arrow in all main views but map view, this is an icon in the bottom left corner of the view window. Clicking it move the view scope up one outline level. If the view is at root level, the icon is greyed out. Expand view is a function equivalent to the Up Arrow feature.


In Outline, Chart, Treemap view Unhoist returns the focus to the root level note(s). This is thus a view of the whole document.

In Map view, it sets a map of the root level notes and containers.

There is no Unhoist shortcut, it must be called from the View menu.

Possible relevant notes (via "Similar Notes" feature):

A Tinderbox Reference File : Misc. User Interface Aspects : Hoist - Unhoist - Expand View - Up Arrow