sphinx-multiversion
Add support for multiple versions to sphinx
Decision gist · record as of 2026-08-14
No, unless you are locked into an old Sphinx version or have no alternative. The package is abandoned (last release 2020-08-12) with no maintenance, bug fixes, or compatibility updates. Modern alternatives or other versioning solutions are more reliable. If you must use it, verify compatibility with your Sphinx version first and expect to maintain it yourself.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires sphinx as a runtime dependency; compatibility with Sphinx versions released after 2020-08-12 is uncertain due to abandonment.
- Low install friction with a single runtime dependency on sphinx.
- However, the package is abandoned—last release was 2020-08-12, over 2193 days ago—so expect no maintenance, bug fixes, or compatibility updates.
License · maintenance · safety
BSD (permissive) — BSD license (permissive) means you can use, modify, and distribute this package freely in commercial and private projects, provided you retain the license notice.
last release 2020-08-12 (2193 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 166,219 downloads/mo, #10,503 on PyPI
Alternatives
Verify before relying
pip install sphinx-multiversion
In conf.py, add to extensions:
extensions = ['sphinx_multiversion']
Then run: sphinx-multiversion -b html docs/ build/html/- Whether this package remains compatible with current Sphinx versions.
- Whether the extension's approach to avoiding Sphinx internals has held up as Sphinx has evolved.
- Real-world success stories or known limitations with modern documentation workflows.
What it is and what it does
sphinx-multiversion is a Sphinx extension designed to automate the building and hosting of multiple versions of documentation from a single repository. Instead of manually managing separate documentation builds for each release, it integrates into your Sphinx workflow to generate versioned docs that can be served together, with a clean UI for switching between versions.
The package depends only on sphinx and aims for a minimal, non-invasive implementation. However, it has been abandoned since 2020-08-12 and has not received updates. This means it was last tested against Sphinx versions from that era, and compatibility with modern Sphinx releases is uncertain. If your project uses a recent Sphinx version or relies on newer Sphinx plugins, this package may not work without modification.
Use it for
- Hosting documentation for multiple released versions of a library or framework on a single domain with version-switching UI.
- Automating doc builds for each git tag or branch to avoid manual version management across releases.
- Building self-hosted versioned docs when you cannot or do not want to use external services.
- Maintaining stable, development, and legacy documentation versions in parallel from a single repository.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
No, unless you are locked into an old Sphinx version or have no alternative.
The package is abandoned (last release 2020-08-12) with no maintenance, bug fixes, or compatibility updates. Modern alternatives or other versioning solutions are more reliable. If you must use it, verify compatibility with your Sphinx version first and expect to maintain it yourself.
Install
sphinx-multiversion on PyPI
Before you install
Low install friction with a single runtime dependency on sphinx. However, the package is abandoned—last release was 2020-08-12, over 2193 days ago—so expect no maintenance, bug fixes, or compatibility updates.
Requires sphinx as a runtime dependency; compatibility with Sphinx versions released after 2020-08-12 is uncertain due to abandonment.
License in practice
BSD license (permissive) means you can use, modify, and distribute this package freely in commercial and private projects, provided you retain the license notice.
Quickstart
pip install sphinx-multiversion
In conf.py, add to extensions:
extensions = ['sphinx_multiversion']
Then run: sphinx-multiversion -b html docs/ build/html/Verify before relying
- Whether this package remains compatible with current Sphinx versions.
- Whether the extension's approach to avoiding Sphinx internals has held up as Sphinx has evolved.
- Real-world success stories or known limitations with modern documentation workflows.
Package facts
| License | BSD permissive |
| Python support | Not specified |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packagesphinx |
| Maintenance | Abandoned 2,193 days since the last release |
| First released | |
| Downloads | 166,219 / month, #10,503 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: BSD LicenseProgramming Language :: Python :: 3Programming Language :: Python :: 3.6Programming Language :: Python :: 3.7 |
Evidence: sphinx_multiversion-0.2.4-py2.py3-none-any.whl; sphinx_multiversion-0.2.4-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 › “sphinx versioned documentation”
- sphinx-multiversionSphinx extension that builds and serves multiple versions of…
- sphinxcontrib-websupportProvides a Python API to integrate Sphinx-generated documentation…
- alabasterAlabaster is a clean, responsive Sphinx theme for documentation that…
Give your agent the search over MCP, or paste the wish link into any chat.
More Sphinx packages
Parses Python docstrings in ReST, Google, Numpydoc, and Epydoc formats, extracting structured information like descriptions, parameters, return types, and exceptions.
Install it if you need to programmatically read and extract structured data from Python docstrings.
Sphinx generates professional documentation from reStructuredText source files, producing HTML, PDF, EPUB, and other formats with automatic cross-references, code highlighting, and hierarchical navigation.
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.
A Sphinx extension that converts documentation source files into QtHelp format, enabling integration with Qt-based help systems and documentation viewers.
However, be aware that maintenance is dormant—if you rely on it long-term, monitor Sphinx compatibility and consider whether QtHelp remains the right format for your…
See also readthedocs-sphinx-ext · mike · sphinxcontrib-log-cabinet · readthedocs-sphinx-search · sphinx-click · antsibull-docs · sphinx-comments · sphinx-favicon · sphinx-data-viewer · python-docs-theme