Version 5.0.0
September 25, 2026
Initial release.
- Writes a developer tip onto every field in every field layout using Craft's own layout-element
tip— stored in project config, deployed with it. - Finds every layout by walking project config: entry types, Matrix entry types, category and tag groups, volumes, global sets, users, addresses, Content Block fields, Commerce product and variant types, and plugin layouts.
- Layout-aware Twig:
block.for Matrix entry types,category./asset./user.on their layouts, the global set's handle, and the layout's handle override when it renames the field. - Describers for 30 core and first-party field types, plus a fallback;
Explainer::EVENT_REGISTER_DESCRIBERSfor plugins. - Ownership ledger in project config: tips a person wrote or edited are never overwritten.
- Automatic rewrites on field save, layout save and field delete, and on install — only where project config is writable.
- Xplain's tips are hidden from authors without the See Xplain's developer tips permission.
- Full explanation on each field's settings screen; Utilities → Xplain; Markdown schema export.
- Console commands
xplain/tips,write,clear,check, andxplain/explain. - Works around Craft's tip renderer double-encoding quotes inside inline code.