This version is out of date, covering development from v6.0.0 to v6.6.5. It is maintained here only for inbound reference links from elsewhere. It is no longer actively updated.

Jump to the current version of aTbRef

TinderboxSix Icon

^include( item|group[, template] )^

Code Type: 

Code Scope of Action: 

Code First Added: 

Code Altered: 

 Data Include   [other codes of this type]

 group   [codes with similar scope]



^include( item|group )^

Includes a single item or group notes, using their default template(s), in the web page for the current note. The scope may also be set from an attribute holding a list of paths or a function returning such a list.

^include( item|group, template )^

Includes the item or group using the specified export template rather than each note(s)' default export template. for instance is a note is set to export a complete page, the default would be inappropriate where the note's output is to be used embedded in another page. In the later case, it is necessary to specify a template that simply returns inline content markup.

IMPORTANT: Tinderbox will not generate HTML links for internal links that point to notes that are only exported via the ^include method; consider linking to the note's (export) parent note instead.


A quoted string literal can be used with either a single item or a group (list):

^include("a note")^ 

^include("a note;another note")^ 

For simple expressions such as string concatenations - which are actually considered expressions, an additional ^value()^ wrapper is needed:

^include(^value("Some"+" note")^)^ --> include note "Some note"

If a stored attribute value is used, group assignments must be enclosed in a ^value()^ code whereas they are not needed for item assignments:


^include($MyString("Some note"))^ 


^include(^value($MyList("Another note"))^)^ 

Expressions must take a ^value()^ wrapper. The most common use with an expression is a find():

^include(^value(find(inside(Some note)))^)^ 


The optional second argument specifies the export template to use when including is evaluated. This permits parameterised constructions like the following:


A Tinderbox Reference File : Export Codes : Export Codes - Full Listing : ^include( item|group[, template] )^