mkdocs-auto-tag-plugin
Add tags to your MkDocs pages based on their path / file name
Decision gist · record as of 2026-08-14
No. While the plugin is permissively licensed and has low install friction, it is abandoned and has not been updated since 2023-08-01. For a documentation site that must remain compatible with current mkdocs versions, the lack of maintenance poses a real risk. Consider it only if you are locked to an older mkdocs version and need this specific functionality.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires mkdocs to be installed and a valid mkdocs.yml configuration file in your project.
- Low friction install as a pure Python wheel with only mkdocs as a runtime dependency.
- However, the project is abandoned—last commit was 2023-08-01 and no updates have been released since the initial release period.
License · maintenance · safety
MIT License (permissive) — MIT License permits commercial and private use, modification, and redistribution with minimal restrictions, making it safe to adopt from a licensing standpoint.
last release 2023-08-01 (1109 days) · last repo commit 2023-08-01
0 known vulnerabilities (OSV.dev, 2026-08-14) · 981,916 downloads/mo, #4,585 on PyPI
Alternatives
Verify before relying
pip install mkdocs-auto-tag-plugin
# In mkdocs.yml, add the plugin:
plugins:
- auto-tag:
globs:
- pattern: 'docs/blog/**'
tags: ['blog']
- pattern: 'docs/api/.*\.md'
tags: ['api']- Whether the plugin remains compatible with current mkdocs versions given the last commit was 2023-08-01.
- Whether regex capture group functionality for dynamic tag generation works as documented.
- Performance impact when applied to large documentation sites with many files.
What it is and what it does
mkdocs-auto-tag-plugin is a MkDocs plugin that automatically tags documentation pages based on their file paths and names. It uses glob patterns to match files and assign one or more tags to matching pages, with optional support for regex patterns and dynamic tag generation via capture groups. The plugin integrates directly into the MkDocs build pipeline and requires only mkdocs as a runtime dependency.
The package is designed for documentation sites that want to organize pages by topic or category without manually adding metadata to each file. It works by inspecting file paths and applying rules defined in the mkdocs.yml configuration. However, the project has been abandoned since its latest release on 2023-08-01 with no recent maintenance, so it may not work with newer mkdocs releases or receive bug fixes.
Use it for
- Automatically tag blog posts by directory (e.g., all files under docs/blog/ get a 'blog' tag).
- Assign API documentation tags based on file path patterns without editing each page.
- Generate dynamic tags from file names using regex capture groups (e.g., extract version from filename).
- Organize large documentation sites by topic using glob-based rules in a single configuration file.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
No.
While the plugin is permissively licensed and has low install friction, it is abandoned and has not been updated since 2023-08-01. For a documentation site that must remain compatible with current mkdocs versions, the lack of maintenance poses a real risk. Consider it only if you are locked to an older mkdocs version and need this specific functionality.
Install
mkdocs-auto-tag-plugin on PyPI
Before you install
Low friction install as a pure Python wheel with only mkdocs as a runtime dependency. However, the project is abandoned—last commit was 2023-08-01 and no updates have been released since the initial release period. Bug fixes and compatibility updates are unlikely.
Requires mkdocs to be installed and a valid mkdocs.yml configuration file in your project.
License in practice
MIT License permits commercial and private use, modification, and redistribution with minimal restrictions, making it safe to adopt from a licensing standpoint.
Quickstart
pip install mkdocs-auto-tag-plugin
# In mkdocs.yml, add the plugin:
plugins:
- auto-tag:
globs:
- pattern: 'docs/blog/**'
tags: ['blog']
- pattern: 'docs/api/.*\.md'
tags: ['api']Verify before relying
- Whether the plugin remains compatible with current mkdocs versions given the last commit was 2023-08-01.
- Whether regex capture group functionality for dynamic tag generation works as documented.
- Performance impact when applied to large documentation sites with many files.
Package facts
| License | MIT License permissive |
| Python support | Supports the current Python release >=3.9 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packagemkdocs |
| Maintenance | Abandoned 1,109 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 981,916 / month, #4,585 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 :: POSIX :: LinuxProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.9 |
Evidence: mkdocs_auto_tag_plugin-0.1.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 › “mkdocs tagging automation”
- mkdocs-auto-tag-pluginAutomatically assigns tags to MkDocs pages based on their file path,…
- mkdocs-include-markdown-pluginA MkDocs plugin that includes content from Markdown files or other…
- mkdocs-meta-managerA MkDocs plugin that automatically applies meta tags to markdown…
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-exclude · mkdocs-meta-manager · mkdocs-autorefs · mkdocs-awesome-pages-plugin · mkdocs-awesome-nav · mkdocs-redirects · mkdocs-gen-files · mkdocs-print-site-plugin · mkdocs-table-reader-plugin · mkdocs-macros-plugin