Field tag

Version: Free.

Why this type

The editor types the labels. There is no fixed options list. It fits filters and labels on cards.

When to use

• Article hashtags, tech stack badges
• Filter facets on landing
• SEO keywords in section block

Tips

Fixed enum fits multiselect or checkboxgroup. Values are strings, not objects.

Similar types

• multiselect for options pick
• checkboxgroup for static flags (Free)

Schema

{
  "name": "labels",
  "type": "tag",
  "label": "Labels",
  "tab": "Content",
  "width": 100,
  "active": true
}

Value

Array of strings.

Section data

Key labels in the section data: array of strings:

{
  "labels": [
    "new",
    "sale"
  ]
}

Chunk example

modx

{foreach $labels as $label}
  <span class="label">{$label}</span>
{/foreach}

fenom

{foreach $labels as $label}
  <span class="label">{$label|pb_text}</span>
{/foreach}

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

See fields overview.

See also

• Field types reference
• Fields overview
• Pro in manager