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_DESCRIBERS for 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, and xplain/explain.
  • Works around Craft's tip renderer double-encoding quotes inside inline code.