Attributes

The attributes an automation command takes, grouped by the command they sit on. An attribute allowed on more than one command is listed under each. Type is the value kind or the fixed set of values it accepts; whether it is required is said in the description. Every attribute name is a record in the reference search.

By command

Attribute	Type	Description
`sitehoster:duplicate`
`name`	text	Required. Ties a master to its copies; use different names for independent blocks.
`role`	`master` · `copy`	Required. Whether this block is the source you edit or a generated copy.
`sitehoster:navigation`
`name`	text	Required. Ties a navigation master to its copies.
`role`	`master` · `copy`	Required. Whether this navigation is the source you edit or a generated copy.
`active`	a key	Required. The key of the item to highlight on this page.
`sitehoster:navigation-item`
`key`	text	Required. Identifies the item; a copy’s `active` matches it.
`sitehoster:record`
`collection`	text	Required. The collection this record joins; other pages list and count by it.
`sitehoster:record-field`
`name`	text	Required. The field name, used as `{{name}}` and in filters, sorts and groups.
`type`	a field type	Optional. One of the field types (default `auto`).
`value`	text	Optional. The value, kept verbatim; omit it to use a fenced ``` block instead.
`sitehoster:listing`
`collection`	text	Required. The collection to pull records from.
`sitehoster:listing-filter`
`field`	a field name	Required. The record field to test.
`op`	an operation	Required. How to compare the field to the value.
`value`	text	Required. The value to compare against.
`sitehoster:listing-sort`
`field`	a field name	Required. The field to order by.
`order`	`asc` · `desc`	Required. The direction: `asc` lowest first, `desc` highest first.
`sitehoster:listing-group`
`by`	a field name	Required. The field to group on.
`using`	a field name	Optional. The field that sorts within each group.
`order`	`asc` · `desc`	Optional. The sort direction within each group.
`start`	integer	Optional. How many to skip within each group (default 0).
`count`	integer	Optional. How many to keep from each group, a maximum (default 1).
`sitehoster:listing-limit`
`start`	integer	How many records to skip (the offset); `start` and/or `count` is required.
`count`	integer	How many records to render; `start` and/or `count` is required.
`sitehoster:count`
`collection`	text	Required. The collection to count.
`sitehoster:count-filter`
`field`	a field name	Required. The record field to test.
`op`	an operation	Required. How to compare it, using the same operators as a listing filter.
`value`	text	Required. The value to compare against.
`sitehoster:count-group`
`by`	a field name	Required. The field to group on before counting.
`using`	a field name	Optional. The field that sorts within each group.
`order`	`asc` · `desc`	Optional. The sort direction within each group.
`start`	integer	Optional. How many to skip within each group (default 0).
`count`	integer	Optional. How many to keep from each group (default 1).

Templates such as listing-item, listing-heading, count-message and the filter-any groups take no attributes; they carry a fenced ``` body instead. See the automation pages for each in full.