NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #2764 most downloaded on PyPI
A clean customisable Sphinx documentation theme.
Last release 9 months ago
19 Dec 2025
Release timing varies
gaps range from 9 days to 12 months
Nearly every release is documented
notes for 34 of 34 stable releases
5 versions withdrawn
withdrawn after publishing
6 years old
79 releases · first in 2020
One column per quarter.
Bump the supported Sphinx version range
Full Changelog: 2025.09.25...2025.12.19
page.html: fix invalid HTML5 by @haampie in #894
Full Changelog: 2025.07.19...2025.09.25
Remove "debug printf" for headerTop value by @ferdnyc in #847
Full Changelog: 2024.08.06...2025.07.19
rel=edit attribute to "Edit this page" link/icon@use + @forwardborder-radius with captions[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci [bot] in #810
Full Changelog: 2024.07.18...2024.08.06
Fix close tag on pencil icon by @kberzinch in #807
Full Changelog: 2024.05.06...2024.07.18
source_view_link configuration handling.[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci [bot] in #779
Full Changelog: 2024.04.27...2024.05.06
Add :visited colour and enforce uniform contrast between light/dark.
--font-stack--headings.:visited colour and enforce uniform contrast between light/dark.:target to reduce back-to-top overlap.source links.Fix canonical url when building with dirhtml.
dirhtml.Make asset hash injection idempotent, fixing Sphinx 6 compatibility.
Fix missing search context with Sphinx 7.2, for dirhtml builds.
require_sphinx() to Sphinx 6.0, in line with dependency changes in Unassuming Ultramarine.Fix compatiblity with Sphinx 7.2.0 and 7.2.1.
Fix compatiblity with Sphinx 7.1.
Improve the screen-reader label for sidebar collapse.
Regenerate with newer version of sphinx-theme-builder, to fix RECORD hashes.
Update Python version classifiers.
✨ Improve footnote presentation with docutils 0.18+.
meta generator tag with a comment.Add ability to set arbitrary URLs for edit button.
Add a minimum version constraint on pygments.
sass.svg in related pages nav.Fix docutils <= 0.17.x compatibility.
docutils <= 0.17.x compatibility.Fix the URL used in the "Edit this page" for Read the Docs builds.
✨ Advertise Sphinx 5 compatibility.
basic-ng as the base theme (from {pypi}sphinx-basic-ng).basic-ng's edit-this-page component.✨ Make sphinx-copybutton look better.
html_baseurl.html_sidebars example.Improve support for print media.
✨ Add a "Back to Top" button that shows up when scrolling up.
optional-dependencies (AKA extras) to dedicated requirements.txt files.Drop a , / for positional-only arguments.
, / for positional-only arguments.✨ Rework typography, pivoting to bold headings.
sphinx-copybutton after copy.display: block on visible only-* elements. (for sphinx-design)div.math equation numbers.:target links are handled.small tag.Improve colours for sphinx-inline-tabs.
sphinx-inline-tabs.html_style is set.pre selector for line-height.Explicitly declare compatibility constraints for pygments.
def on function and method signatures.sig-prename.Fix a typo, that broke the sidebar highlight logic.
Tweak API documentation presentation to match pdoc3's style.
- Fix RECORD file contents.
Adopt sphinx-theme-builder, which runs the JS-based asset build process during the regular Python build process.
sphinx-theme-builder, which runs the JS-based asset build process during the regular Python build process.show_sphinx is set to False.Add a bit more space below content icon container.
html_logo and html_favicon.Use noscript for search js notification by @jdknight in https://github.com/pradyunsg/furo/pull/245
Full Changelog: https://github.com/pradyunsg/furo/compare/2021.09.08...2021.09.22
noscript for presenting "search needs JS" message.support various footer configurations by @jdknight in https://github.com/pradyunsg/furo/pull/225
Full Changelog: https://github.com/pradyunsg/furo/compare/2021.08.31...2021.09.08
Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6
Full Changelog: https://github.com/pradyunsg/furo/commits/2021.08.31
pygments_dark.css.Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6
Full Changelog: https://github.com/pradyunsg/furo/commits/2021.08.17.beta43
Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6
Full Changelog: https://github.com/pradyunsg/furo/commits/2021.08.11.beta42
Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6
Full Changelog: https://github.com/pradyunsg/furo/commits/2021.07.31.beta41
Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6
Full Changelog: https://github.com/pradyunsg/furo/commits/2021.07.28.beta40
Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6
Full Changelog: https://github.com/pradyunsg/furo/commits/2021.07.28.beta39
Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6
Full Changelog: https://github.com/pradyunsg/furo/commits/2021.07.05.beta38
Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6
Full Changelog: https://github.com/pradyunsg/furo/commits/2021.06.24.beta37
Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6
Full Changelog: https://github.com/pradyunsg/furo/commits/2021.06.18.beta36
Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6
Full Changelog: https://github.com/pradyunsg/furo/commits/2021.06.18.beta35
Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6
Full Changelog: https://github.com/pradyunsg/furo/commits/2021.04.11.beta34
Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6
Full Changelog: https://github.com/pradyunsg/furo/commits/2021.04.11.beta33
Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6
Full Changelog: https://github.com/pradyunsg/furo/commits/2021.04.11.beta32
[source]) allowing wrapping of API
signatures gradefully.Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6
Full Changelog: https://github.com/pradyunsg/furo/commits/2021.03.20.beta31
pygments_dark_style working.Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6
Full Changelog: https://github.com/pradyunsg/furo/commits/2021.03.20.beta30
Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6
Full Changelog: https://github.com/pradyunsg/furo/commits/2021.03.19.beta29
kbd tags.Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6
Full Changelog: https://github.com/pradyunsg/furo/commits/2021.02.28.beta28
Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6
Full Changelog: https://github.com/pradyunsg/furo/commits/2021.02.28.beta27
margin: auto.json builder, by not passing functions into the
Jinja templates.domainindex.html, about it not being implemented.Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6
Full Changelog: https://github.com/pradyunsg/furo/commits/2021.02.27.beta26
Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6
Full Changelog: https://github.com/pradyunsg/furo/commits/2021.02.21.beta25
pygments_dark_style is Furo-specificsphinx-panels respond to dark mode with Furodefering Javascript, which was causing search to break in some cases.Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6
Full Changelog: https://github.com/pradyunsg/furo/commits/2020.12.30.beta24
pygments_dark_style is changed.Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6
Full Changelog: https://github.com/pradyunsg/furo/commits/2020.12.28.beta23
Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6
Full Changelog: https://github.com/pradyunsg/furo/commits/2020.12.28.beta22
pygments_dark_style.genindex pages.
html_split_index is not supported at this time.language_data.js to search page, fixing Stemmer related failures in Sphinx 3.4.layout.html from Sphinx's basic theme.Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6
Full Changelog: https://github.com/pradyunsg/furo/commits/2020.12.09.beta21
Use functools.lru_cache with maxsize=None by @sethmlarson in https://github.com/pradyunsg/furo/pull/6
Full Changelog: https://github.com/pradyunsg/furo/commits/2020.12.09.beta20
Your coding agent can read these notes before it upgrades. Set up the MCP server →