Widgets

Available widget partials and their parameters

Documentations

Blocks

Variable-type list field for page builder blocks.

Boolean

Toggle / checkbox field.

Code

Code editor field with optional syntax highlighting.

Color

Color picker.

Compute

Read-only field derived from the other fields of the entry.

Datetime

Date and time picker.

File

File upload field. Use type to restrict to a specific media category.

Image

Image upload field.

List

Repeatable list of fields (an array of objects).

Map

Map / geolocation field.

Markdown

Rich text / markdown editor.

Number

Numeric input or range slider.

Object

Groups multiple fields into a collapsible object.

Relation

Relation field — links to another collection entry.

Select

Dropdown select field.

String

Single-line text input.

Text

Multi-line plain text input.

UUID

Auto-generated UUID field, read-only in the editor.

Instead of writing raw CMS-specific YAML or JSON, you call a widget partial and pass a standardized dict. The widget internally handles the output format for each supported CMS (Decap, Sveltia, CloudCannon, Pages CMS, TinaCMS…), so the same field definition works across all of them without any change.

Widgets are Hugo partials that generate CMS field configuration. Each widget is called with a dict of parameters.

{{- $args := dict
  "label" (i18n "admin.fields.title.label")
  "name"  "title"
  -}}
{{ partial "admin/widgets/string.js" $args }}

Parameters marked required must always be provided.