--- id: mike version: "2.2.0" license: BSD-3-Clause license_treatment: permissive maintenance: active --- # mike — Manage multiple versions of your MkDocs-powered documentation License: permissive · Maintenance: active · Downloads: 1.6M/mo ## What it is and what it does mike is a deployment tool for MkDocs that solves the problem of hosting multiple versions of documentation simultaneously. Instead of rebuilding all versions every time you release, mike lets you deploy each version once and then leave it untouched—old docs built with old MkDocs versions stay frozen in your gh-pages branch, eliminating breakage from upstream MkDocs changes. It works by creating Git commits on your deployment branch for each version, with support for aliases (like 'latest' or 'dev') that can point to specific versions via symlinks, HTML redirects, or file copies. The package integrates with MkDocs via a plugin that adds a version selector widget to your documentation and manages site URLs. You deploy with `mike deploy`, serve locally with `mike serve` to test all versions, and delete old versions with `mike delete`. Configuration happens in mkdocs.yml or via command-line flags, letting you customize alias behavior, redirect templates, deployment prefixes, and canonical version hints for search engines. Use it for: - Host stable and development versions of docs side-by-side, with aliases pointing to specific versions. - Maintain documentation for multiple major versions without rebuilding older docs when MkDocs updates. - Create permanent URLs to specific documentation versions for linking in changelogs or support tickets. - Test versioned documentation locally before pushing to production using `mike serve`. - Manage documentation for libraries with long-term support branches by deploying each branch version independently. ## Worth the install? AI-flagged interpretation of the facts above — verify before relying. mike deploys multiple versions of MkDocs-generated documentation to a Git branch (typically gh-pages), managing version history and aliases without rebuilding or modifying older docs. Yes. mike is actively maintained, has no known vulnerabilities, low install friction, and solves a real problem for projects using MkDocs. It's well-suited for any project that needs to host multiple documentation versions without the overhead of rebuilding or managing them manually. The BSD-3-Clause license is permissive. Install it if you maintain MkDocs documentation and need version management. ## Install pip install mike uv add mike poetry add mike ## Installing mike Before you install: Low install friction; pure Python wheel with 8 runtime dependencies including mkdocs, jinja2, and pyyaml. Active maintenance with last commit 2026-08-01 and 737 repository stars. License in practice: BSD-3-Clause permissive license allows commercial and private use with minimal restrictions; suitable for most projects. Quickstart: pip install mike mike deploy [version] [alias] mike serve Requires an existing MkDocs project with mkdocs.yml configuration and a Git repository with a gh-pages branch (or equivalent deployment branch). Verify before relying: - Whether mike works with non-GitHub Git hosting (GitLab, Gitea, etc.) or only GitHub Pages. - Performance characteristics when managing many documentation versions. - Compatibility with MkDocs themes other than the officially supported ones. - Minimum Python version requirements (classifiers list 3.8 through 3.13 but requires_python is unspecified). ## Package facts - License: BSD-3-Clause (permissive) - Python support: unspecified - Install friction: low - Maintenance: active - Downloads: 1.6M/month (top 5,000 on PyPI) - Known vulnerabilities: none known ## Tags mkdocs versioned documentation, deploy multiple doc versions git, github pages doc versioning, mkdocs version selector, documentation version management, gh-pages multi-version docs, mkdocs deployment tool, mkdocs-plugin, version-management, gh-pages [View on SkillFed](https://skillfed.io/packages/mike) · [View on PyPI](https://pypi.org/project/mike/)