mkdocs-git-committers-plugin-2
An MkDocs plugin to create a list of contributors on the page. The git-committers plugin will seed the template context with a list of GitHub or GitLab committers and other useful GIT info such as last modified date
Decision gist · record as of 2026-08-14
Yes, if you use MkDocs and want to display contributor metadata on your documentation pages. The plugin has low install friction, no known vulnerabilities, and integrates well with Material for MkDocs. The aging maintenance status is not a blocker—the last commit was recent (June 2025) and the plugin is stable. Provide a GitHub or GitLab token to avoid rate limits and unlock full functionality like co-author detection.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires a GitHub or GitLab API token for GitLab repositories; GitHub token optional but recommended to avoid rate limits (60 requests per hour per IP without token).
- Low friction install via pip.
- The package is in aging maintenance status with a last commit in June 2025, but remains actively used with 142000 monthly downloads and no known vulnerabilities.
License · maintenance · safety
MIT (permissive) — MIT license permits unrestricted use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.
last release 2025-01-30 (561 days) · last repo commit 2025-06-05 · 71 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 142,000 downloads/mo, #11,227 on PyPI
Alternatives
Verify before relying
pip install mkdocs-git-committers-plugin-2
# In mkdocs.yml:
plugins:
- git-committers:
repository: organization/repository
# Access in template:
{% for user in committers %}
{{ user }}
{% endfor %}- Whether the plugin works with all MkDocs versions or has specific version constraints beyond Python 3.8+.
- Performance impact of API calls per page during large documentation builds.
- Whether GitLab user identification issues (issue #50) have been resolved since the last release.
What it is and what it does
This MkDocs plugin integrates contributor metadata into your documentation by querying GitHub or GitLab APIs to fetch the list of committers for each page. It displays contributor avatars and last-modified dates directly in your documentation, typically integrated into the Material for MkDocs theme but usable in custom templates as well.
The plugin works by fetching contributor data from GitHub or GitLab rather than parsing local git logs, which improves accuracy and eliminates the need to match commit authors manually. It caches results to speed up subsequent builds, only re-fetching when a page has changed. For GitHub, it counts commit authors, committers, and co-authors (with a token); for GitLab, it counts commit authors only. Configuration is minimal—just specify your repository and optionally provide an API token for private repos or to increase rate limits.
Use it for
- Display contributor avatars and names on documentation pages to credit team members and encourage community contributions.
- Show the last-modified date on each page to help readers understand content freshness and recency.
- Integrate contributor metadata into Material for MkDocs theme without additional configuration.
- Track and display co-authors on documentation pages when using GitHub's co-author commit feature.
- Support both GitHub and GitLab repositories in the same documentation pipeline.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you use MkDocs and want to display contributor metadata on your documentation pages.
The plugin has low install friction, no known vulnerabilities, and integrates well with Material for MkDocs. The aging maintenance status is not a blocker—the last commit was recent (June 2025) and the plugin is stable. Provide a GitHub or GitLab token to avoid rate limits and unlock full functionality like co-author detection.
Install
mkdocs-git-committers-plugin-2 on PyPI
Before you install
Low friction install via pip. The package is in aging maintenance status with a last commit in June 2025, but remains actively used with 142000 monthly downloads and no known vulnerabilities.
Requires a GitHub or GitLab API token for GitLab repositories; GitHub token optional but recommended to avoid rate limits (60 requests per hour per IP without token).
License in practice
MIT license permits unrestricted use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.
Quickstart
pip install mkdocs-git-committers-plugin-2
# In mkdocs.yml:
plugins:
- git-committers:
repository: organization/repository
# Access in template:
{% for user in committers %}
{{ user }}
{% endfor %}Verify before relying
- Whether the plugin works with all MkDocs versions or has specific version constraints beyond Python 3.8+.
- Performance impact of API calls per page during large documentation builds.
- Whether GitLab user identification issues (issue #50) have been resolved since the last release.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release <4,>=3.8 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 3 packagesmkdocsrequestsgitpython |
| Maintenance | Aging 561 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 142,000 / month, #11,227 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaIntended Audience :: DevelopersIntended Audience :: Information TechnologyLicense :: OSI Approved :: MIT LicenseProgramming Language :: PythonProgramming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9 |
Evidence: mkdocs_git_committers_plugin_2-2.5.0-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 contributor attribution”
- mkdocs-git-committers-plugin-2MkDocs plugin that fetches and displays a list of contributors to…
- mkdocs-git-authors-pluginA MkDocs plugin that extracts and displays the git authors of the…
- blurbblurb is a command-line tool that manages CPython's release notes by…
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-localized-plugin · mkdocstrings · mkdocs-git-revision-date-plugin · mkdocs-material · mkdocs-techdocs-core · mkdocs-multirepo-plugin · mkdocs-monorepo-plugin · mkdocs-print-site-plugin · mkdocs-video