NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #3792 most downloaded on PyPI
Mkdocs plugin that enables displaying the localized date of the last git modification of a markdown file.
Last release 20 days ago
14 Sep 2026
Ships fairly regularly
a new release about every 2 months
Most releases are documented
notes for 51 of 58 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
58 releases · first in 2019
Every page asked git which tag pointed at its commit, and asked again for the site-wide revision commit — the same answer, recomputed for each page. T
Every page asked git which tag pointed at its commit, and asked again for the site-wide revision commit — the same answer, recomputed for each page. Those lookups are now cached.
The bigger your site, the more you save: on a 1000 page site this removes roughly 18 seconds of build time.
custom_format keeps your own wordsIf your format had any text around the date directives, that text came out scrambled:
custom_format: "Updated on %d %B %Y"before: Up23AMt723 on 23 January 2022
now: Updated on 23 January 2022
Any format that was made up purely of % directives (including the %d. %B %Y default) was unaffected and still renders exactly as before. Unrecognised directives such as %Q are now left alone instead of being quietly reinterpreted as a different date field.
page.meta.git_creation_date_localized_hash and page.meta.git_creation_date_localized_tag were documented but always came back empty. If you use them in a theme override to link back to the commit or release that introduced a page, they now contain what you expect.
The warning that tells you your dates will be wrong because CI only fetched part of the history was silently skipped whenever your .git was not in the directory you ran mkdocs from — a repository inside docs/, or a temporary checkout made by plugins such as monorepo. It now fires there too.
type: now produces a proper MkDocs config error listing the valid values, instead of a bare AssertionError.enable_parallel_processing: false actually does, rather than suggesting a fallback it never attempted.The package ships py.typed, so mypy, pyright and ty can see the plugin's annotations.
mkdocs build --strict is now stricter. Warnings from this plugin previously bypassed MkDocs' warning counter, so --strict ignored them. They now count.
In practice this means a build that combines --strict with a shallow clone will start failing where it used to pass — most commonly GitHub Actions, which checks out with fetch-depth: 1 by default. The dates in that build really are wrong, so the right fix is to fetch the full history:
- uses: actions/checkout@v6
with:
fetch-depth: 0If you would rather keep the build passing as-is, set strict: false in the plugin config to downgrade these messages:
plugins:
- git-revision-date-localized:
strict: falseMinimum MkDocs version is now 1.4. The plugin already required MkDocs 1.4 APIs to import at all; the metadata said >=1.0, which meant a resolver could install a combination that could never work. Nothing changes for anyone on 1.4 or newer.
One column per quarter.
Raises the gitpython floor from >=3.1.44 to >=3.1.59 .
Raises the gitpython floor from >=3.1.44 to >=3.1.59.
Earlier dependabot bumps only touched this repo's uv.lock, which pins the CI
environment and nothing else. Downstream users installing from PyPI resolved
against pyproject.toml, so they could still land on a GitPython carrying the
2026 option-injection advisories — GHSA-wvpp-8hx9-p66j and GHSA-jm78-9fvv-mhgr
among them, all patched by 3.1.58, with further option hardening in 3.1.59.
This plugin never passes user input as git options, so it was not exploitable
through those. The floor bump forces the upgrade in environments that already
hold an older GitPython, and clears the warnings downstream scanners report.
Thanks to @nucleus-ffm for reporting it in #222.
Full Changelog: v1.5.3...v1.5.4
Fix paths in MANIFEST.in by @mitya57 in #211
Guard against page is None in mkdocs theme override Jinja2 templates by @Copilot in #202
page is None in mkdocs theme override Jinja2 templates by @Copilot in #202Full Changelog: v1.5.1...v1.5.2
Add documentation for Alpine Linux Docker usage by @Copilot in https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/pull/199
prek (https://prek.j178.dev/)Full Changelog: https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/compare/v1.5.0...v1.5.1
prek (https://prek.j178.dev/)Full Changelog: v1.5.0...v1.5.1
Drop support for 3.8, do not unit test for 3.9. Add support for 3.14 by @timvink in https://github.com/timvink/mkdocs-git-revision-date-localized-plug
Full Changelog: https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/compare/v1.4.7...v1.5.0
Full Changelog: v1.4.7...v1.5.0
Fix tests for click >= 8.2.0 by @mgorny in https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/pull/187
Full Changelog: https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/compare/v1.4.6...v1.4.7
add timezone to title in span element by @mschoettle in https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/pull/175
options.md by @zyv in https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/pull/179Full Changelog: https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/compare/v1.4.5...v1.4.6
options.md by @zyv in #179Full Changelog: v1.4.5...v1.4.6
Fix monorepo compability for techdocs by @timo-reymann in https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/pull/174
Full Changelog: https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/compare/v1.4.4...v1.4.5
Full Changelog: v1.4.4...v1.4.5
Fix regression causing verbose output by @timvink in #171
Full Changelog: v1.4.3...v1.4.4
Fix for generated files when using parallel processing by @timvink in #171
Full Changelog: v1.4.2...v1.4.3
Fix monorepo compatibility by @timvink in https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/pull/168
Full Changelog: https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/compare/v1.4.0...v1.4.1
New option enable_parallel_processing (default: True) for a 2-5x speedup by @kunickiaj in https://github.com/timvink/mkdocs-git-revision-date-localize
enable_parallel_processing (default: True) for a 2-5x speedup by @kunickiaj in https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/pull/116, and by @timvink in https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/pull/166ignored_commits_file enabling you to to ignore specific commits by @allanlw in #114, and @timvink in https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/pull/157type: custom, the locale is now properly respective by @timvink in https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/pull/165Full Changelog: https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/compare/v1.3.0...v1.4.0
🟠 Minor breaking changes: This release will change some of the git revision dates:
🟠 Minor breaking changes: This release will change some of the git revision dates:
git log --ignore_all_space --ignore_blank_lines.git log diff-filter=r command (see git log docs)git log --follow. While giving more accurate revision and creation dates, there is an edge case: if you commit empty files, the revision date might wrong. For details see this blogpost. You can opt-out of this behavior by using the new option enable_git_follow (which defaults to True). If you still hit inaccurate revision dates for specific files, consider manually defining them.Pull requests:
Full Changelog: https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/compare/v1.2.9...v1.3.0
Fixed another DeprecationWarning by @YigesMx in https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/pull/144
Full Changelog: https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/compare/v1.2.8...v1.2.9
Fixed the bug that the configuration option theme.language in mkdocs.yml was not fetched correctly under the mkdocs-material theme by @Xiaokang2022 in
theme.language in mkdocs.yml was not fetched correctly under the mkdocs-material theme by @Xiaokang2022 in https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/pull/143Full Changelog: https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/compare/v1.2.6...v1.2.8
fixed a timeago display bug by @ketikai in https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/pull/141
Full Changelog: https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/compare/v1.2.6...v1.2.7
Fix bitbucket CI warning showing up on github actions, by @timvink in https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/issues/136
Full Changelog: https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/compare/v1.2.5...v1.2.6
Fixing _vars deprecation warning by @dbermuehler in https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/pull/132
_vars deprecation warning by @dbermuehler in https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/pull/132Full Changelog: https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/compare/v1.2.4...v1.2.5
- Revert jinja auto escape #126 Full Changelog: https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/compare/v1.2.3...v1.2.4
Full Changelog: https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/compare/v1.2.3...v1.2.4
To prepare for next major mkdocs release: For jinja autoescape, mark HTML strings as safe, not needing escaping by @oprypin in https://github.com/timv
Full Changelog: https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/compare/v1.2.2...v1.2.3
Correctly check for truthiness of generated_by by @oprypin in https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/pull/124
generated_by by @oprypin in https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/pull/124Full Changelog: https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/compare/v1.2.1...v1.2.2
Remove usage of datetime.utcfromtimestamp to avoid deprecated warnings in python 3.12 by @timvink in https://github.com/timvink/mkdocs-git-revision-da…
datetime.utcfromtimestamp to avoid deprecated warnings in python 3.12 by @timvink in https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/pull/122Full Changelog: https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/compare/v1.2.0...v1.2.1
Add support for mkdocs-gen-files by @timvink in https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/pull/102
Features:
mkdocs-gen-files by @timvink in https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/pull/102Documentation:
Full Changelog: https://github.com/timvink/mkdocs-git-revision-date-localized-plugin/compare/v1.1.0...v1.2.0
When enable_creation_date is enabled (default is False), this plugin will use git --follow to find the creation date. If you have renamed files in the
enable_creation_date is enabled (default is False), this plugin will use git --follow to find the creation date. If you have renamed files in the past this extra git option will attempt to find the original creation date of the file. The only side effect is that the creation date for new, empty files might be older. See #90 for details. Contributed by @blueswenSupport setting git log to show signature (#88). Contributed by @ianrobrien
git log to show signature (#88). Contributed by @ianrobrienTwo new features, and marking the milestone as a v1 release.
Two new features, and marking the milestone as a v1 release.
locale on a per-page basis (#73). See docscustom type that you can change using the custom_format options (#82). See docsFix bug where timezone setting was not properly used.
Bug where {{ git_site_revision_date_localized }} would not be properly replaced (#78). Contributed by @awesomeindustries
{{ git_site_revision_date_localized }} would not be properly replaced (#78). Contributed by @awesomeindustries❤️ Thanks for the contributions @patrick-5546 @awesomeindustries @oliversalzburg @Rwarcards762
Drop explicit support for python 3.6 as it is end of life (package will still work on 3.6), see stop using python 3.6
New variables for when site was last updated (any page in the docs/ folder)
docs/ folder) (#19)Thanks to @eliroca for contributing this release!
Removed unnecessary extra git log operations when adding new raw date formats page.meta tags
Regressions from 0.10.1:
git log operations when adding new raw date formats page.meta tagspage.meta where actually the revision dates.Exposed different date variants as raw strings in page.meta for developers customizing themes
page.meta for developers customizing themes (#64)New enabled option to disable the plugin via the configuration, see docs.
enabled option to disable the plugin via the configuration, see docs. (#58)Improve compatibility with mkdocs-material instant loading feature, fixes #61, #60, #59.
mkdocs-material instant loading feature, fixes #61, #60, #59.Thanks @ErliSoares for contributing this release! 🎉
Bug where mkdocs build would crash if enable_creation_date was enabled in combination with a page that had been renamed in git (multiple creation date
mkdocs build would crash if enable_creation_date was enabled in combination with a page that had been renamed in git (multiple creation dates not expected). (c4fdfea)New {{ git_creation_date_localized }} tag available, thanks to @PegasisForever
{{ git_creation_date_localized }} tag available, thanks to @PegasisForever (#50)page.meta prefix when using in a regular markdown context (ddfb9f8).0.xInside any markdown (.md) files, replace any occurances of {{ page.meta.git_revision_date_localized }} with
{{ git_revision_date_localized }}
exclude parameter to prevent adding a revision date to certain pages #43
exclude parameter to prevent adding a revision date to certain pages #43blackended codeflake8 and fixed corresponding issuesThanks @RDIL for your contributions in this release! 🎉
Upgraded timeago.js dependency from 2.x to 4.0.2
timeago.js dependencies are now injected from the package, removing the need to use a CDN. Closes #39, #40 and #42
Support for symlinks #41, thanks @AndreasBieber 🎉 , also closes #34
Plugin now properly supports mkdocs-material theme's instant loading feature, closes https://github.com/squidfunk/mkdocs-material/issues/1918
mkdocs-material theme's instant loading feature, closes https://github.com/squidfunk/mkdocs-material/issues/1918Extended warnings when running on build servers to Azure and Bitbucket pipelines.
<span> elements around date output to allow for easy CSS stylingtype: timeago would result in blank output for the date. Now proper fallback to type: iso_date #12fallback_to_build_date was not always throwing proper warnings
fallback_to_build_date was not always throwing proper warningsmkdocs to >=1.0jinja2README.mdFix, did not release all commits intended in v0.5.1
Fix, did not release all commits intended in v0.5.1
🎉 Thanks to all contributors to this release @biochimia @oxr463 @marianafantini @williammizuta
🎉 Thanks to all contributors to this release @biochimia @oxr463 @marianafantini @williammizuta
fallback_to_build_date in error messages #26 (by @biochimia )time.time() to obtain unix timestamp #27 (by @biochimia ).git directory in mkdocs docs_dir, and traverses upward. #31 #33Big thanks to @Guts for all his work on this release!
Big thanks to @Guts for all his work on this release!
locale did not change date format output #21fallback_to_build_date that uses the build date instead of a git date. Useful when git is not available in build environment #20black-ened codelogging.debug() statementsFallback of current timestamp in always in UTC timezone
var for compatibility (5ebd009), thanks @RDIL !Nothing published for this version
Nothing published for this version
Fixed #6, now timeago is rendered on page load instead of page build
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Installation via pypi now works by adding empty __init__.py
Installation via pypi now works by adding empty __init__.py
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →