(Quick Reference)

1 Introduction - Reference Documentation


Version: 2.1.0-SNAPSHOT

1 Introduction

The Fields plugin allows you to customize the rendering of input fields for properties of domain objects, command beans and POGOs based on their type, name, etc. The plugin aims to:
  • Use good defaults for fields.
  • Make it very easy to override the field rendering for particular properties or property types without having to replace entire form templates.
  • Not require you to copy and paste markup for containers, labels and error messages just because you need a different input type.
  • Support inputs for property paths of arbitrary depth and with indexing.
  • Enable other plugins to provide field rendering for special property types that gets picked up automatically (e.g. the Joda Time plugin can provide templates for the various date/time types).
  • Support embedded properties of GORM domain classes.


Version 1.5


  • Changelog will be completed shortly.

See Usage and Customizing Field Rendering for breaking changes.

Browse issues

Version 2.0

  • Redesign for Grails 3.0

Version 1.4

  • Upgraded plugin to work with Grails 2.3.x (Issue #122)
  • Fixed missing property exception (Issue #134)
  • Fixed encoding in tag libraries (Issue #137)
  • Configuring caching in dev mode (Issue #139)
  • byte and Byte arrays types now look for files in byteArray folders (general for all array types) (Issue #144)

Browse issues

Version 1.3


  • Adds the f:display tag.
  • Supports overriding templates by property type or by default in individual controllers and actions.

Browse issues

Thanks to Rick Jensen Konstantinos Kostarellis Gus Power and Eliot Sykes for their contributions.

Version 1.2


  • Pass attributes from `f:field` to the rendered input using `input-` prefix.
  • Optionally use entire property path for label key.

Browse issues

Thanks to Brian Saville and OverZealous for contributions.

Version 1.1


  • Adds the prefix attribute.
  • Support `widget:'textarea'` constraint.

Browse issues

Thanks to Brian Saville for contributions.

Version 1.0.4

2012-02-13 : Bugfix release.

Browse issues

Version 1.0.3

2012-02-09 : Bugfix release.

Browse issues

Version 1.0.2

2012-02-07 : Bugfix release.

Browse issues

Version 1.0.1

2012-02-03 : Bugfix release.

Browse issues

Version 1

2012-02-01 : Initial release.

Browse issues