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.