Field formatter class settings on the manage-display tab, showing a custom class being added to a term reference field.
Example of HTML markup produced by Field formatter class module. The custom class is highlighted on the field wrapper DIV.

Allows site administrators to add classes to the outer HTML wrapper for any field display, so that CSS and Javascript can target them.

It's particulary useful for adding classes required by various jQuery plugins and CSS grid systems.


The Field Formatter Class settings are found in the Manage display tab for content types, users, and other entities. A text box is available for each field, revealed by using the formatter settings edit button (gear wheel icon) for that field.

The class is added to the outer <div> container for the field. The default Drupal field classes (e.g. "field-type-taxonomy-term-reference") remain available - this module does not remove any classes.

The accompanying screenshot images show the settings form and some example HTML output.

This module works well in tandem with Field Group. Note that this module only adds classes to field formatters; to add classes to field groups, use the settings provided by the Field Group module.



The Drupal 7 version depends on Field Formatter Settings API module.

Development status

Drupal 7:

Field formatter class is now feature-complete. Future development for D7 will be limited to bug fixes and/or security issues.

Drupal 8:

#D8CX: The D8 version is well on track.
Follow progress at #1938146: [META] D8 port of field formatter class.

Known Issues

There is a compatibility problem when using this module in combination with the extra fields provided by Display Suite. The issue potentially affects all modules which implement Field formatter settings API, and a solution is being explored in the Display suite project.
See #1616426: Compatibility with Display Suite

Supporting organizations: 
sponsored maintainer's time (andrewmacpherson) for D8 port

Project Information