A visually rich, interactive tool for viewing and exploring content revision histories in Drupal.
Use 3.x for new projects.
As of 3.x the module no longer relies on recording some Revision history in a custom table.
Overview
Revision Graph transforms the standard Drupal revision history into an intuitive, visual graph that makes it easy to understand content changes over time. This is particularly valuable for:
- Content editors managing complex content with multiple contributors
- Site administrators tracking content changes and revision history
- Editorial teams visualizing workflow and content evolution
Features for Content Creators
- Interactive Visual Timeline: See all content revisions displayed as an interactive graph
- Revision Details: Click on any revision to view commit details including author, date, and message
- Contextual Information: Visualize when changes were made with date markers
- Branch Visualization: Easily identify different content branches and how they merge
- Tag Support: Highlight important revisions with tags for quick reference
- Accessibility Features: Fully navigable by keyboard with screen reader support
Features for Site Builders
- Zero Configuration: Works out of the box with any content type that has revisions enabled
- Performance Optimized: Efficiently handles content with large revision histories
- Compatible with Core: Works with standard Drupal revision functionality
Installation
-
Download and install the module as you would normally install a contributed Drupal module.
composer require drupal/revision_graph
-
Enable the module through the Drupal admin interface, or via Drush:
drush en revision_graph
-
No additional configuration is required. The module is ready to use.
Usage for Content Creators
Viewing Revision History
- Navigate to any content page that has revisions
- Click on the "Revision Graph" tab (located next to standard "Revisions" tab)
- The revision graph will display, showing the complete history of the content
Understanding the Graph
- Nodes (Circles): Each circle represents a single revision
- Connecting Lines: Show the relationship between revisions
- Date Markers: Horizontal lines indicating when revisions were made
- Branch Labels: Text at the top of each column showing branch names which is the language code.
- Highlighted Current Revision: The active revision is highlighted
Working with Revisions
- View Revision Details: Click on any revision circle to see detailed information
- Navigate Between Revisions: Use keyboard arrow keys to move between revisions
-
Access Revision Actions: Each revision has a menu with options like:
- View this revision
- Revert to this revision
- Compare with current revision
Usage for Site Builders
Enabling for Content Types
The module automatically adds the Revision Graph tab to any content type that has revisions enabled. To ensure it works with your content:
- Go to Structure > Content types > [Your content type] > Edit
- Expand the "Publishing options" section
- Check "Create new revision" to enable revisions
- Save the content type
Customization Options
The graph appearance can be customized by:
- Theme Overrides: Override the CSS classes in your theme to match your site's design
- Dark Mode Support: The graph automatically detects and adapts to dark mode themes
Troubleshooting
The Revision Graph Tab Doesn't Appear
- Ensure that revisions are enabled for the content type
- Verify that the user has proper permissions to view revisions
- Clear the Drupal cache (
drush cr)
The Graph Doesn't Display Correctly
- Check for JavaScript errors in your browser's console
- Try clearing your browser cache
- Ensure your browser is up to date (the graph uses modern JavaScript features)
Performance Issues with Large Revision Histories
- The graph is optimized for performance, but extremely large revision histories (hundreds of revisions) may cause slowdowns
- Consider pruning old revisions if they're no longer needed.
Permissions
The module uses Drupal core's revision permissions:
-
view all revisions: Required to see the Revision Graph tab - No additional permissions are needed
Support and Contribution
- For support requests, use the issue queue
- For bug reports or feature suggestions, please provide detailed information including your Drupal version and steps to reproduce
- Contributions are welcome through the standard Drupal contribution process
Maintainers
- Shibin Das - D34dMan
Supporting organizations:
Development
Project information
- Project categories: Administration tools, Content editing experience
102 sites report using this module- Created by d34dman on , updated
Stable releases for this project are covered by the security advisory policy.
Look for the shield icon below.
