Field imask

Version: Pro.

Why this type

Phone, tax id, card pattern without validate-only. Mask or preset in schema. Pro advanced-fields.

When to use

• Phone in contact_form fields
• SKU or serial with fixed format
• Promo code pattern

Tips

Plain numeric use number. Value is string with mask literals per preset.

Similar types

• text without format constraint
• url for links, not phone mask

Schema

{
  "name": "phone",
  "type": "imask",
  "label": "Phone",
  "mask": "+7 (000) 000-00-00",
  "maskOptions": {
    "lazy": false
  },
  "tab": "Content",
  "width": 100,
  "active": true
}

Value

Masked string.

Section data

Key phone in the section data: masked string:

{
  "phone": "+7 (495) 123-45-67"
}

Chunk example

<a href="tel:{$phone|escape}">{$phone|escape}</a>

Notes

Short mask: mask. Full IMask config: maskOptions (object or JSON string).

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: mask or maskOptions (IMask JSON).

See fields overview.

See also

• Field types reference
• Fields overview
• Pro in manager