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

Do you like what you are reading? Subscribe to receive updates.

Unsubscribe anytime