INCLUDE( ) or +( )

Specifies nodes to include when building a dynamic output.

INCLUDE([ parameter; parameter; ... ] [ flags ... ])
shorthand:
+([ parameter; parameter; ... ] [ flags ... ])
Use semicolon or newline to separate the arguments.

Example

[[
INCLUDE(keyword = example value)

]]

Parameters

  • key name operator value
    • key name may be:
      • any key name in the project, including system keys
      • * matches “any key”
    • operator may be one of:
      • = “equals / is”
      • ? “contains”
      • before “is before” (for comparing Timestamps)
      • after “is after” (for comparing Timestamps)
    • value may be:
      • any metadata value in — or not in — the project. Values not in the project will return empty results
      • * matches “any value”
  • * with no operator will include all nodes in the project

When multiple parameters are included in a single INCLUDE() directive, only the nodes meeting all are included.

To include nodes from multiple independent parameters, use multiple INCLUDE() directives.

Flags

  • -title_only : includes nodes that contain only a title, no additional text. See Node Titles for more information.
  • -untitled : includes only untitled nodes (nodes with no text except metadata, dynamic definitions, or embedded/escaped syntax.
  • -is_meta : includes only nodes for which the value(s) of the key and operator are themselves a node. See Nodes as Metadata Values.
  • -is_not_meta : includes only nodes for which the value(s) of the key and operator are not a node.
  • -dynamic : includes dynamic nodes. Not included by default.