title: Query: Action List
role: manual
tags: #manual #search #zettelstore
syntax: zmk
back: 00001007700000
backward: 00001007700000
box-number: 1
copyright: (c) 2020-present by Detlef Stern <ds@zettelstore.de>
created: 20230707205246
forward: 00001006034000 00001006035500 00001007701000 00001007710000 00001007720000
lang: en
license: EUPL-1.2-or-later
modified: 20260226180655
published: 20260226180655
visibility: public

With a [list of zettel identifiers](00001007710000), a [query directives](00001007720000), or a [search expression](00001007701000), a list of zettel is selected.
*Actions* allows modifying this list to a certain degree.

Which actions are allowed depends on the context.
However, actions are further separated into *parameter action* and *aggregate actions*.
A parameter action just sets a parameter for an aggregate action.
An aggregate action transforms the list of selected zettel into a different, aggregate form.
Only the first aggregate form is executed, following aggregate actions are ignored.

In most contexts, valid actions include the name of metadata keys, at least of type [Word](00001006035500) or [TagSet](00001006034000).

To allow some kind of backward compatibility, an action written in uppercase letters that leads to an empty result list, will be ignored.
In this case the list of selected zettel is returned.

An empty action sequence is treated as if no vertical bar character (&ldquo;`|`&rdquo;, U+007C) was specified.

# Aggregate actions



# Parameter actions

