Field tv

Version: Free.

Why this type

The editor picks a resource template variable (TV). On the site its value is printed as [[*{$tv.name}]]. The section does not copy the value. It only names which TV to read.

When to use

• Section reads resource TV chosen by editor
• Shared hero image TV across templates
• Dev tooling which TV to expose

Tips

TV value is not duplicated in the section data. Inline upload in section is image or file.

Similar types

• chunk pick chunk by name
• relation pick resource not TV

Schema

{
  "name": "tv",
  "type": "tv",
  "label": "TV",
  "tab": "Content",
  "width": 100,
  "active": true
}

Value

Object { id, name, caption }.

Section data

Key tv in the section data:

{
  "tv": {
    "id": 7,
    "name": "hero_image",
    "caption": "Hero image"
  }
}

Chunk example

modx

[[*tvname]]

fenom

{$_modx->resource[$tv.name]}

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