INCLUDE( ) or +( )

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 parameters 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.