Drupal is a registered trademark of Dries Buytaert

INTRODUCTION

The Taxonomy Machine Name Field Formatter module provides a field formatter for taxonomy reference fields that outputs term properties in a list of separate fields per term.

Note from the author:

  • It’s another one of those "scratch my own itch" modules.
  • I created this module to get results quickly and because I was unsure about the current maintenance state of the parent Taxonomy Machine Name project.
  • The end goal is to contribute this formatter back and merge it into the parent module, if the maintainers are interested in adopting and maintaining this code.

Primary use cases:

  • Expose raw string-based values to front-end consumers or APIs as predictable key/value data.

REQUIREMENTS

INSTALLATION

Install as you would normally install a contributed Drupal module.
See: https://www.drupal.org/node/895232 for further information.

CONFIGURATION

  • Add or edit an entity display that includes a taxonomy term reference field.
  • Choose the Machine name with Label output
  • Configure options:
    • Link label to the referenced entity
    • Link and label as seperated items
  • Save the display settings.

The option Link and label as seperated items is only available if you turned Link label to the referenced entity on.

Output

The variables per term passed to the template are a combination of the following fields

Array
(
    [machine_name] => Array
        (
            [#type] => inline_template
            [#template] => {{ value }}
            [#context] => Array
                (
                    [value] => some_term
                )
        )

    [link] => Array
        (
            [#type] => inline_template
            [#template] => {{ value }}
            [#context] => Array
                (
                    [value] => /taxonomy/term/2
                )
        )
    [label] => Array
        (
            [#type] => inline_template
            [#template] => {{ value }}
            [#context] => Array
                (
                    [value] => Some Term
                )
        )
    [label] => Array
        (
            [#type] => link
            [#title] => Some term
            [#url] => {\Drupal\Core\Url}
            [#options] => Array 
                (
                    [entity_type] => taxonomy_term
                    [entity] => {\Drupal\Core\Entity\Term}
                    [language] => {\Drupal\Core\Language\Language}
                )
        )        
)

Activity

Total releases
1
First release
Nov 2025
Latest release
3 months ago
Release cadence
Stability
0% stable

Releases

Version Type Release date
1.0.x-dev Dev Nov 13, 2025