Query: Action List

00001007770000 · Ref · Info · (manual) · #manual #search #zettelstore (all) · Context

With a list of zettel identifiers, a query directives, or a search expression, 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 or TagSet.

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 (“|”, U+007C) was specified.

Aggregate actions

KEYS: Returns a list of all metadata keys of the given list of zettel.; | KEYS returns the list of all metadata keys managed by this Zettelstore.
REDIRECT: Redirects to the first zettel of the given list of zettel identifiers.; PICK 1 | REDIRECT will show a random zettel.
REINDEX: Updates the internal search index for the selected zettel identifier. It allows to specify a second aggregate action.; 20260226163200 IDENT | REINDEX updates the internal search index for a zettel with the identifier 20260226163200.
Word: If Word is a metadata key of type Word or TagSet, return an aggregate of the given metadata key.; | role returns a list of all used role values.; | tags returns a list of all tags specified in this zettelstore.

Parameter actions

MAXn: Returns only those values with at most n aggregated values. n must be a positive integer.; | MAX13 tags returns only those tags that are used at most in 13 zettel.
MINn: Returns only those values with at least n aggregated values. n must be a positive integer.; | MIN3 tags returns only those tags that are used at least in 3 zettel.
N: Returns a numbered list of zettel in the Web User Interface, instead of an unnumbered list. Ignored when specified for an API call.; | N returns a numbered list of all zettel in the Web User Interface.