Skip to content

Link formatter#

The Link (link) formatter displays values as plain text or as a themed link with various options for setting attributes and link text.

Settings#

Setting Label Description Default
link_text Link text An optional input to display text as the instead of the url
trim_length Trim link text length An optional to trim displayed link text to desired length 80
url_only URL only An option to only display url regardless of link text value FALSE
url_plain Show URL as plain text An option to display the url as plain text FALSE
rel Add rel="nofollow" to links An option to set the nofollow rel attribute
target Open external link in new window An option to set the target="_blank" attribute to external links
noopener Add rel="noopener" to links An option to set the noopener attribute to external links when Open external link new window is checked
noreferrer Add rel="noreferrer" to links An option to set the noreferrer attribute to external links when Open external link new window is checked
title Title An optional input to add a title attribute to the link
aria-label ARIA label An optional input to add an aria-label attribute to the link
class Class An optional input to add classes to the link
id ID An optional input to add an id attribute to the link
name Name An optional input to add a name attribute to the link
accesskey Access key An optional input to add an accesskey attribute to the link

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#