EXCLUDE() or -()

Specifies nodes to exclude when building a dynamic output.

Always evaluated after INCLUDE()

Parameters

Accepts all the same parameters as INCLUDE():

  • 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 EXCLUDE() directive, only the nodes meeting all parameters are exclude. To exclude nodes from multiple independent parameters, use multiple EXCLUDE() directives.

Flags

Accepts all the same flags as INCLUDE():

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

in addition to:

  • -including_as_descendants : When using TREE(), excludes the specified nodes even if they appear as descendants of included nodes.