Skip to main content
drupalreleases

Use direct release data with your AI assistant.

Learn more

Field Tokens

Security covered Maintenance fixes only 844 sites

This module provides extended token functionality for Drupal fields, allowing you to insert formatted field values or specific field properties directly into text. It supports advanced options for selecting which field items to include and can integrate with other modules for more flexible token usage.

The Field Tokens module adds two additional types of field tokens: Formatted fields and field properties.

Formatted field tokens

Formatted Field tokens are tokens allowing one or many field values to be rendered via the default or specified field formatter.

The format is:

[PREFIX:DELTA(S):FORMATTER:FORMATTER_SETTING_KEY-FORMATTER_SETTING_VALUE:...]

(e.g. [node:field_image-formatted:0,1:image:image_style-thumbnail]).

Formatter settings that are themselves arrays (e.g. the image formatter's image_loading) can be set using dot notation in the setting key:

[PREFIX:DELTA(S):FORMATTER:PARENT.CHILD-VALUE:...]

Field property tokens

Field property tokens are tokens allowing access to field properties on one or many fields.

Properties are dependent on the field type.

The format is:

[PREFIX:DELTA(S):PROPERTY]

(e.g. [node:field_image-property:0:entity:url]).

When a field property stores an array, additional colon-separated segments traverse into the value using each segment as a key:

[PREFIX:DELTA(S):PROPERTY:KEY:KEY:...]

Entity delta token

A delta token is available on every entity token type (e.g. [file:delta], [node:delta]). It returns the zero-based position of the entity within its parent multi-value field. The delta is provided at runtime by the calling code.

Delta specification

The DELTA(S) position supports multiple formats for selecting which field item values to render:

  • Single: 0
  • Comma-separated: 0,2,4
  • Range: 0-2
  • Mixed: 0-2,4,6-8
  • Wildcard: *
  • Omitted: all field items

Custom Formatters integration

When used with the Custom Formatters module, tokens like [formatted_field-image:image:...] and [field_property:alt] can be used directly in HTML + Token formatters without entity-level chaining.

Required modules

Recommended modules

Drupal 10–11

Ask your assistant about Field Tokens

Check compatibility with your Drupal and PHP version, maintenance and security coverage, from current release data. How it works

Depends on

Dependencies of the latest stable release

Required by

Tracked projects that depend on this one

No tracked projects depend on this one yet.

Activity

Tracked releases
4
Tracked since
Feb 2024
Latest release
4 months ago
Releases (12 mo)
3 ▲ from 0
Maintenance
Active

Release Timeline

Releases

Version Type Core PHP Release date
2.0.0 Stable 10–11 Jul 8, 2026
2.0.0-rc4 Pre-release 10–11 Jun 18, 2026
2.0.x-dev Dev 10–11 May 26, 2026
2.0.0-rc2 Pre-release 9–10 Feb 8, 2024