Query Block
A block that embeds a live query: the matching documents render in place as cards, a list or a table.

Extends

id
The block's permanent identity inside its document.
inherited
revision
Output only: CID of the last Change that modified this block.
optional · inherited
type
Block type tag, always `Query`.
Queryoptional
attributes
The stored query and how its results are shown.
childrenType
How this block lays out its children — a children type such as `Unordered` or `Grid`.
optional
columnCount
Number of card columns in the `Card` style (default 3).
optional
textAlignment
Horizontal alignment of the block's text — a text alignment such as `center`; omitted for the default `left`.
optional
style
How results are shown: `Card`, `List` or `Table`.
optional
query
The query to run: spaces and paths to include, sort and limit.
banner
Show the first result as a banner.
optional
table
Column settings for the `Table` style.
optional

A query block is a live listing. The author stores a query in place of a copied list of pages, and every reader sees the current result. Attributes: query (required; the spaces and paths to include, the sort and the limit), style (a query style: Card, List or Table), columnCount (card columns, default 3), banner (show the first result as a banner), table (a table config for the table view), and the parent-layout pair. A folder page is usually one query block over its own children. See Blocks and the query grammar.

See also