mkdocs-git-revision-date-plugin
MkDocs plugin for setting revision date from git per markdown file.
Decision gist · record as of 2026-08-14
No—the package is abandoned (last release 2022-03-08, no commits since 2023-03-28) and will receive no maintenance or bug fixes. While it has low install friction and a permissive license, relying on unmaintained software for a core documentation feature creates long-term risk. Consider an actively maintained alternative or fork if this functionality is essential.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires a Git repository initialized in the documentation source directory; the plugin reads Git history to determine revision dates.
- Low install friction with three straightforward runtime dependencies (mkdocs, GitPython, jinja2).
- However, the package is abandoned—last release was 2022-03-08, over 1620 days ago—so no maintenance or bug fixes should be expected.
License · maintenance · safety
MIT (permissive) — MIT license is permissive, allowing use, modification, and distribution with minimal restrictions, making it safe to integrate into most projects.
last release 2022-03-08 (1620 days) · last repo commit 2023-03-28 · 61 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 147,923 downloads/mo, #11,048 on PyPI
Alternatives
Verify before relying
pip install mkdocs-git-revision-date-plugin
Then in mkdocs.yml:
plugins:
- search
- git-revision-date
In your template:
{% if page.meta.revision_date %}
Updated {{ page.meta.revision_date }}
{% endif %}- Whether the package works with current MkDocs versions (last tested 2022-03-08, no recent maintenance signal)
- Compatibility with Python versions beyond 3.4 in practice (requires_python states >=3.4 but no recent testing evidence)
What it is and what it does
This MkDocs plugin automatically extracts the last Git commit date for each documentation page and makes it available to your site templates and Markdown files. It integrates with MkDocs' plugin system and exposes the revision date as `page.meta.revision_date` in templates or `{{ git_revision_date }}` in Markdown, formatted in ISO date format (YYYY-mm-dd) by default. The plugin depends on mkdocs, GitPython, and jinja2.
The package is designed for documentation sites where you want to show readers when content was last updated, pulling that information directly from your Git history rather than maintaining it manually. It supports optional features like environment-gated builds, disabling Markdown substitution, and outputting dates as Python datetime objects for custom formatting via Jinja2.
Use it for
- Display 'last updated' timestamps on documentation pages without manual maintenance
- Show readers when API documentation or guides were last revised based on Git commits
- Automatically populate footer or sidebar metadata with page revision dates in MkDocs sites
- Format revision dates using Jinja2 date filters when datetime output is enabled
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
No—the package is abandoned (last release 2022-03-08, no commits since 2023-03-28) and will receive no maintenance or bug fixes.
While it has low install friction and a permissive license, relying on unmaintained software for a core documentation feature creates long-term risk. Consider an actively maintained alternative or fork if this functionality is essential.
Install
mkdocs-git-revision-date-plugin on PyPI
Before you install
Low install friction with three straightforward runtime dependencies (mkdocs, GitPython, jinja2). However, the package is abandoned—last release was 2022-03-08, over 1620 days ago—so no maintenance or bug fixes should be expected.
Requires a Git repository initialized in the documentation source directory; the plugin reads Git history to determine revision dates.
License in practice
MIT license is permissive, allowing use, modification, and distribution with minimal restrictions, making it safe to integrate into most projects.
Quickstart
pip install mkdocs-git-revision-date-plugin
Then in mkdocs.yml:
plugins:
- search
- git-revision-date
In your template:
{% if page.meta.revision_date %}
Updated {{ page.meta.revision_date }}
{% endif %}Verify before relying
- Whether the package works with current MkDocs versions (last tested 2022-03-08, no recent maintenance signal)
- Compatibility with Python versions beyond 3.4 in practice (requires_python states >=3.4 but no recent testing evidence)
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.4 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 3 packagesmkdocsGitPythonjinja2 |
| Maintenance | Abandoned 1,620 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 147,923 / month, #11,048 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
Evidence: mkdocs_git_revision_date_plugin-0.3.2-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 › “mkdocs last modified date”
- mkdocs-git-revision-date-pluginAdds a Git-based revision date to MkDocs documentation pages,…
- mkdocs-git-revision-date-localized-pluginA MkDocs plugin that displays the date of the last git modification…
- mkdocs-git-authors-pluginA MkDocs plugin that extracts and displays the git authors of the…
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-revision-date-localized-plugin · mkdocs-git-authors-plugin · mkdocs-rss-plugin · mkdocs-git-committers-plugin-2 · mkdocs-awesome-pages-plugin · mkdocs-with-pdf · mkdocs-video · mike · mkdocs-llmstxt · mkdocs