Docs /Mason

02-field.md

Configuring a field

Add a field of type Mason to a channel field group (Developer → Fields → New Field → Type: Mason).

Editor Mode

  • Rich Text + Bricks (default) — the full editor plus the brick inserter.
  • Rich Text Only — prose only; no bricks.
  • Bricks Only — bricks only; no rich-text toolbar.

Toolbar

Which formatting tools this field offers — the equivalent of EE's RTE configurations, scoped per field. Bricks-Only fields have no toolbar, so this setting doesn't apply to them.

  • Basic — bold, italic, link.
  • Standard — adds underline, strikethrough, headings and lists.
  • Full (default) — adds alignment, tables, images, blockquote, code, sub/superscript, abbreviation and the horizontal rule.
  • Custom — pick individual tools from the Custom tools checklist below the setting.

Your custom picks are remembered even while a named preset is selected, so you can switch back to Custom without re-ticking everything.

Abbreviation marks a run of text as an abbreviation and asks what it stands for, so RSS reaches the site as <abbr title="Really Simple Syndication">RSS</abbr>. Select the text first (or put the cursor inside an existing abbreviation to change it); leave the prompt empty to remove it. Screen readers don't reliably announce a title, so spell a term out in full the first time it appears and don't rely on the abbreviation alone. A field saved with a custom toolbar before 1.18.0 doesn't gain the tool until you tick Abbreviation.

Buttons are grouped — text marks, headings, lists and blocks, alignment, inserts, styles — with a thin divider between groups. The dividers follow whichever tools are on, so a custom toolbar is grouped the same way as a preset; there is nothing to configure.

The toolbar stays pinned to the top of the field as you scroll a long entry, just below ExpressionEngine's publish tabs.

Narrowing a toolbar is safe. It only hides buttons — it never unloads the underlying editor features. Formatting already in a field (a table, an image, a code block) keeps loading, displaying and saving correctly even if the tool that created it is no longer offered. Authors simply can't add new formatting of that kind.

A brick's Rich text field has its own, separate toolbar setting using the same presets — see Field kinds → Rich text.

Editor height

The minimum height of the editing area in pixels (default 200).

Bricks

A checklist of every brick in the global library. Tick the ones this field should offer authors. Manage the library itself under Mason → Bricks — there's a link right in the setting.

If no bricks exist yet, you'll see a prompt to create your first one.