Skip to content

Map table formatter#

The Map table (map_table) formatter displays a table of key-value pairs.

Settings#

Label Setting Description Default
Key label key_label The table header label for key column Key
Value label value_label The table header label for value column Value

Style settings#

These additional style settings give you complete control over the HTML markup generated by each subfield. This is one of the most powerful features of the Custom Field module for theming.

By customizing the wrapper tags and classes, you can:

  • Create clean, semantic HTML that matches your theme’s design system
  • Target individual subfields precisely with CSS (using subfield name and type)
  • Reduce CSS specificity issues and override battles
  • Improve accessibility and SEO with proper semantic elements (<section>, <article>, <h3>, etc.)
  • Easily integrate with CSS frameworks like Tailwind, Bootstrap, or custom component libraries

Default behavior (when left empty) produces a <div> wrapper with intelligent, predictable classes based on the subfield name and type — giving you excellent theming hooks right out of the box.

Setting Label Description
field_wrapper_tag Field wrapper tag HTML element that wraps the entire field + label
field_wrapper_class Field wrapper class Optional additional classes (space separated)
field_tag Field tag HTML element that wraps only the field value
field_class Field classes Optional field value classes (space separated)
label_tag Label tag HTML element that wraps the label
label_class Label classes Optional label classes (space separated)

Field types#