Queries

Queries allow you to filter, sort and manipulate data collections. Queries can be used on Collections provided by Eleventy Notes or any other list of objects you want to manipulate.

Usage #

Define a query in the front matter of a note and use the query filter to apply it to a list of objects.

---
myQuery:
  filter: ... # see below
  sort: ... # see below
---

# My Notes

{{ collections.notes | query(myQuery) }}

Query Properties #

Filtering #

The filter property allows you to filter the data collection. The filter property is an array of filter rows. Each filter row is an array with three elements: the property to filter on, the operator and the value of the operator.

myQuery:
  filter:
    # A list of filter rows that must all match
    # Format: ["<property>", "<operator>", <value>]

    # Title must match the given RegEx pattern
    - ["title", "matches", "^Book:"]

      # Note must have the tag "book"
    - ["tags", "includes", "book"]

Operators #

The following operators are available:

Operator	Description
isEmpty	The property must be empty
isNotEmpty	The property must not be empty
isEqual	The property must be equal to the value
isNotEqual	The property must not be equal to the value
isLessThan	The property must be less than the value
isLessThanOrEqual	The property must be less than or equal to the value
isGreaterThan	The property must be greater than the value
isGreaterThanOrEqual	The property must be greater than or equal to the value
includes	The property must include the value
doesNotInclude	The property must not include the value
includesAnyOf	The property must include any of the values
includesAllOf	The property must include all the values
includesNoneOf	The property must include none of the values
matches	The property must match the given RegEx pattern

And / Or #

By default, all provided conditions must match. You can change this behavior by passing an object with either an and or or property. These objects can also be nested:

myQuery:
  filter:
    or:
      # either condition must match
      - ["tags", "includes", "book"]
      - and:
          # both conditions must match
          - ["title", "matches", "^Book:"]
          - ["tags", "isEmpty"]

The example above filters all notes that have the tag book OR that have the title Book: AND no tags.

Sorting #

The sort property allows you to sort the data collection. The sort property is an array of sort rows. Each sort row is an array with two elements: the property to sort on and the sort direction.

myQuery:
  sort:
    # A list of sort rows
    # Format: ["<property>", "<direction>"]

    # Sort by the "sort" data property in ascending order
    - ["data.sort", "asc"]

    # Sort by the "title" property in descending order
    - ["title", "desc"]

Tree #

The tree property allows you to transform the data collection into a tree structure. The tree is created by a path property that is split on a separator.

myQuery:
  # Convert the collection into a tree
  tree: true

anotherQuery:
  tree:
    # The property that contains the path
    # default: filePathStem
    pathProp: "data.tree"

    # A list of path replacements (optional)
    replace:
      # Replace the "Demo/" prefix with an empty string
      "^/Demo/": ""

If tree is enabled, it will transform each item in the collection into a tree node. The tree node has the following properties:

[
  {
    // A unique key for the node
    $treeKey: "my-folder--my-note",

    // The name of the current path segment
    $treeName: "My Note",

    // The list of child nodes
    children: [],

    // ... any existing properties of the item
  },
];

Offset and Limit #

The offset and limit properties allow you to limit the number of items returned by the query.

myQuery:
  # The number of items to skip
  offset: 10

  # The maximum number of items to return
  limit: 5