Skip to main content
drupalreleases

Use direct release data with your AI assistant.

Learn more

Field History

Security covered Under active development 3 sites

This module adds a tab to revisioned nodes that shows which fields were changed and when.

Field History adds a Field History tab to nodes that shows when each field changed and what it changed from. Drupal's revision UI compares two revisions at a time. This module reads every revision of a node and shows the history of one field at a time, skipping revisions where the field didn't change.

Features

  • Overview table at /node/{nid}/field_history. Every revisionable field on the node is listed with its current value, its previous value and the date it last changed.
  • Per-field timeline at /node/{nid}/field_history/{field_name}. Each revision in which the field changed is listed, newest first and 50 per page, with its revision ID, its timestamp and the field value as rendered at that revision.
  • Raw values: append /raw, or use the View Raw Values link, to see the stored field item values instead of rendered output. This helps when debugging references, formatted text or multi-value fields.
  • Works on configurable fields and on revisionable base fields such as title, status and owner, and on the translation being viewed.
  • Emptying a field and reordering the values of a multi-value field both count as changes.
  • No configuration. History is read from the node revisions Drupal already keeps; the module only caches which revisions changed each field.

Requirements

  • Drupal 10.3 or later, Drupal 11 or Drupal 12.
  • Nodes whose content types create new revisions. Fields are tracked only while revisions are being saved.

Installation and use

  1. Install the module as usual: composer require drupal/field_history, then drush en field_history.
  2. Grant the View Node Field History permission to the roles that need it. The permission is marked as restricted because it exposes past values of every field.
  3. Those roles also need one of core's revision permissions: View all revisions, {Content type}: View revisions, Administer content or Bypass content access control. Users must also be able to view the node, and fields they cannot view are hidden.
  4. Open any node and click the Field History tab.

Limitations

  • Only nodes are supported. Other revisionable entity types, such as media, block content and taxonomy terms, are not.
  • The first view of a node after a new revision loads each of its revisions once to find the changes. Later views use a cache and load only the revisions they show.

Documentation

See the Field History documentation for configuration, troubleshooting and the API for custom code.

How this module is built

Changes to this module since 2026 were drafted with an AI coding assistant (Claude Code). The maintainers review, test and take responsibility for every change, and the tests and code checks run on drupal.org's CI. Contributions follow Drupal's policy on the use of AI when contributing.

Supporting this module

Developed and maintained by Tyler Brown Cifu Shuster of FivePaths, LLC. Development sponsored by FivePaths.

Drupal 10–11 PHP >=8.1

Ask your assistant about Field History

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

No dependencies recorded for this project.

Required by

Tracked projects that depend on this one

No tracked projects depend on this one yet.

Activity

Tracked releases
3
Tracked since
Sep 2024
Latest release
1 month ago
Releases (12 mo)
2 ▲ from 0
Maintenance
Active

Release Timeline

Releases

Version Type Core PHP Release date
1.0.1 Stable 10–11 PHP >=8.1 Oct 9, 2026
1.0.0 Stable 10–11 PHP >=8.1 Oct 9, 2026
1.0.x-dev Dev 9–11 Sep 11, 2024