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

linkedFrom("item"[,linkType])


Operator Type: 

Operator Scope of Action: 

Operator Purpose: 

Operator First Added: 

Operator Altered: 

 Function   [other Function type actions]

 Item   [operators of similar scope]

 Query Boolean   [other Query Boolean operators]

 Already in v5.0.0

 5.8.05.9.0


linkedFrom("item"[,linkType])

Returns true if the current note is linked to from item; this is optionally filtered to only links of type linkType. Put another way, "Does an outbound link exist from item to the current note?" or "Does an inbound link exist to the current note to item?".

This is effectively only a query term, it returns a Boolean. If you are trying to collect data about the linked note(s), use links() instead.

The item parameter must be quoted unless an attribute reference, e.g. "Some note" vs $MyString. Ways to define item. Scope is a single note only. Links of type 'prototype' are ignored. Used in an agent, 'this' note is the alias in the agent and not its original, making this action unsuitable for testing in a agent action.

From v5.8.0, as an exception to the operator's normal item-scope, a wildcard "*" designator is allowed which matches all notes. From 5.9.0, item may be group scoped including use of group designators and operators like find(), collect and links().

If using linkType, you must use the value "*untitled" to match an 'untitled' type link (rather than "" or "untitled").

In the query creation pop-ups of agent and Find dialogs this function is listed as "linked from".

This replaces the legacy #linkedFrom query operator.

The logical opposite of this test is linkedTo().

From v5.9.0 this function can target an alias as opposed to an original (if the logical choice) and can accept a group scope.


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


A Tinderbox Reference File : Actions & Rules : Operators : Full Operator List : linkedFrom("item"[,linkType])