Field keyvalue

Version: Pro.

Why this type

Simpler than table for single text value column. KeyLabel and valueLabel customize captions. Free row count without column schema.

When to use

• Meta attributes, params, simple specs
• Custom props for chunk
• Name/value list without cell types

Tips

Typed cells or image in cell need table. Single flat map sometimes beats repeater of two text fields.

Similar types

• table for typed grid
• repeater with two text fields (Free)

Schema

{
  "name": "meta",
  "type": "keyvalue",
  "label": "Meta",
  "keyLabel": "Parameter",
  "valueLabel": "Value",
  "tab": "Content",
  "width": 100,
  "active": true
}

Value

Array of { key, value }.

Section data

Key meta in the section data: array of pairs:

{
  "meta": [
    {
      "key": "author",
      "value": "PageBuilder"
    },
    {
      "key": "version",
      "value": "1.0"
    }
  ]
}

Chunk example

{foreach $meta as $row}
  <div><strong>{$row.key|escape}:</strong> {$row.value|escape}</div>
{/foreach}

Notes

Column labels: keyLabel, valueLabel (or key_label / value_label).

Common properties

For fields with name that are stored in the section data:

Key	Type	Role	CMP
tab	string	Group subtitle in the inspector	yes
width	25–100	Field width as % of the row (flex)	yes
description	string	Hint under the label	yes
default	any	Initial value for a new section	yes
active	bool	false hides the field in the inspector	yes
required	bool	Required on publish (draft still saves)	yes

• Also: keyLabel, valueLabel (or key_label / value_label).

See fields overview.

See also

• Field types reference
• Fields overview
• Pro in manager