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


Tinderbox supplies a number of 'designator' terms, use of which instead of a note's $Name or path which may infer an individual note, or in a few cases a group of notes. Item designators are generally hierarchical in their references.

There are also separate series of designators designed to help date creation/calculation and the polarity of links.

Most item and group designators can use paths to refer to data from a different note from the current context. This makes them even more flexible in use - the section on paths for more detail.

Designators are generally used with attribute value references ($Name(parent)), as action or export code parameters (linkTo(grandparent), linkFrom(grandparent(original))). In some cases cases they are specific to certain operators, as with links() and the link direction designators.

Designators ignore map adornments.

In action code, designators used as path proxies - e.g. $Name(parent) - may safely be quoted. Historically, path arguments weren't quoted but in v5 there has been a move to explicitly quoting all string values.

Designators are listed via their scope:

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

A Tinderbox Reference File : Objects & Concepts : Designators