mkdocs-git-revision-date-localized-plugin
Mkdocs plugin that enables displaying the localized date of the last git modification of a markdown file.
Decision gist · record as of 2026-08-14
Yes, if you use MkDocs with material theme or are willing to customize your theme. The plugin is actively maintained, has no known vulnerabilities, low install friction, and solves a common documentation need (showing last-modified dates) without manual effort. The main gotcha is ensuring your CI/CD system fetches full git history; once configured, it works reliably.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires git repository access with full commit history; CI/CD systems must set fetch-depth to 0 (or equivalent) to retrieve modification dates correctly.
- Low friction installation as a pure-Python wheel.
- The package is actively maintained with a recent release (74 days ago) and has been stable since its initial 2019 release.
License · maintenance · safety
MIT (permissive) — MIT license is permissive; you can use, modify, and distribute this plugin freely in commercial and private projects with minimal restrictions.
last release 2026-06-01 (74 days) · last repo commit 2026-08-09 · 270 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 1,634,007 downloads/mo, #3,702 on PyPI
Alternatives
Verify before relying
pip install mkdocs-git-revision-date-localized-plugin
Then add to mkdocs.yml:
plugins:
- search
- git-revision-date-localized- Whether the plugin works with all MkDocs themes or only material theme without additional customization.
- Performance impact on build times for large documentation sites with many pages.
What it is and what it does
This is a MkDocs plugin that automatically extracts the date of the last git commit affecting each markdown page and displays it in localized format on the rendered site. It integrates with the MkDocs build pipeline to query git history and uses babel for locale-aware date formatting, plus timeago.js for relative date display (e.g., "2 days ago").
The plugin works out-of-the-box with the mkdocs-material theme, which natively displays the revision date at the bottom of pages. Other themes require manual template customization. A key constraint is that it needs full git history available during the build—shallow clones in CI/CD systems will fail unless configured to fetch the complete history.
Use it for
- Display 'last updated' timestamps on documentation pages built with mkdocs-material to show readers when content was last revised.
- Automatically track page freshness in technical documentation without manual date maintenance in frontmatter.
- Generate localized date strings in multiple languages for international documentation sites using babel's locale support.
- Integrate git-based revision tracking into CI/CD documentation builds by configuring fetch-depth appropriately.
- Show relative timestamps (e.g., '3 weeks ago') via timeago.js for a more human-readable revision indicator.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you use MkDocs with material theme or are willing to customize your theme.
The plugin is actively maintained, has no known vulnerabilities, low install friction, and solves a common documentation need (showing last-modified dates) without manual effort. The main gotcha is ensuring your CI/CD system fetches full git history; once configured, it works reliably.
Install
mkdocs-git-revision-date-localized-plugin on PyPI
Before you install
Low friction installation as a pure-Python wheel. The package is actively maintained with a recent release (74 days ago) and has been stable since its initial 2019 release. Requires mkdocs and three other common dependencies (babel, gitpython, tzdata).
Requires git repository access with full commit history; CI/CD systems must set fetch-depth to 0 (or equivalent) to retrieve modification dates correctly.
License in practice
MIT license is permissive; you can use, modify, and distribute this plugin freely in commercial and private projects with minimal restrictions.
Quickstart
pip install mkdocs-git-revision-date-localized-plugin
Then add to mkdocs.yml:
plugins:
- search
- git-revision-date-localizedVerify before relying
- Whether the plugin works with all MkDocs themes or only material theme without additional customization.
- Performance impact on build times for large documentation sites with many pages.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 4 packagesbabelgitpythonmkdocstzdata |
| Maintenance | Actively maintained 74 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 1,634,007 / month, #3,702 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14 |
Evidence: mkdocs_git_revision_date_localized_plugin-1.5.3-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “localized page modification time”
- mkdocs-git-revision-date-localized-pluginA MkDocs plugin that displays the date of the last git modification…
- sphinx-last-updated-by-gitA Sphinx extension that automatically extracts and displays the…
- humanizeConverts numbers, dates, times, and file sizes into human-readable…
Give your agent the search over MCP, or paste the wish link into any chat.
More Documentation packages
Docutils converts plaintext documentation in reStructuredText format into multiple output formats including HTML, XML, and LaTeX using a modular processing system.
Sphinx generates professional documentation from reStructuredText source files, producing HTML, PDF, EPUB, and other formats with automatic cross-references, code highlighting, and hierarchical navigation.
Griffe extracts the complete structure and signatures of Python programs to generate API documentation or detect breaking changes in your project's public API.
Install it if you need to programmatically inspect Python code structure, generate API docs, or enforce API stability in CI.
A Sphinx extension that outputs documentation in serialized HTML formats (JSON and pickle) alongside standard HTML.
Alabaster is a clean, responsive Sphinx theme for documentation that requires Python 3.10 or newer and Sphinx 6.2 or newer.
A Sphinx extension that generates HTML help files from reStructuredText documentation source.
See also mkdocs-git-authors-plugin · mkdocs-git-revision-date-plugin · mkdocs-git-committers-plugin-2 · mkdocs-static-i18n · mdformat-mkdocs · mkdocs-print-site-plugin · mkdocs-material · mkdocstrings · mkdocs-multirepo-plugin · mkdocs-video