Field combo

Version: Pro.

Why this type

Database list: modResource, modTemplate, and other whitelist classes. Loaded via mgr/field/options and pbOnFieldValues. Dropdown search without a relation modal.

When to use

• Pick template, chunk, or TV by xPDO class
• Store a related record id when the chunk does not need pagetitle
• Dynamic enum from MODX tables

Tips

Resource with pagetitle in data → relation. Multiple values → multicombo.

Similar types

• select for a static options list
• tablecombo for a custom table row id

Schema

{
  "name": "related",
  "type": "combo",
  "label": "Related",
  "optionsSource": {
    "class": "modResource"
  },
  "tab": "Content",
  "width": 100,
  "active": true
}

Value

Selected value (string or id).

Section data

Key related in the section data: string or id from optionsSource:

{
  "related": 5
}

Chunk example

{$related|escape}

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