NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #1525 most downloaded on PyPI
Read the Docs theme for Sphinx
Last release 8 months ago
12 Jan 2026
Ships unpredictably
gaps range from 8 days to 13 months
Most releases are documented
notes for 28 of 36 stable releases
Nothing withdrawn
no release was ever pulled
13 years old
64 releases · first in 2013
Supports docutils 0.22 and Sphinx 9.x
Supports docutils 0.22 and Sphinx 9.x
3.1.0rc2 with support for docutils 0.22
One column per quarter.
Added support for docutils 0.22
Co-authored-by: humitos 244656+humitos@users.noreply.github.com
Initial plan
Add support for Sphinx 9.0.0
Co-authored-by: humitos 244656+humitos@users.noreply.github.com
Update docs
Use Sphinx 9.x for documentation
Added changelog entry and bumped version to 3.1.0rc1
Remove 3.1.0 from development file
Revert version
Update release following our docs
https://sphinx-rtd-theme.readthedocs.io/en/stable/contributing.html#releasing-the-theme
Add deleted text by mistake
Update Python supported versions
Co-authored-by: copilot-swe-agent[bot] 198982749+Copilot@users.noreply.github.com
Co-authored-by: humitos 244656+humitos@users.noreply.github.com
Co-authored-by: Manuel Kaufmann humitos@gmail.com
Show current translation when the flyout is attached
Show current translation when the flyout is attached
Fix JavaScript issue that didn't allow users to disable selectors
Use black color for text in selectors.
Use black color for text in selectors.
Final version. .. _release-3.0.0rc4:
Final version.
Trigger "Read the Docs Search addon" when focusing the "Search docs" input in the navbar.
Trigger "Read the Docs Search addon" when focusing the "Search docs" input in the navbar.
Show hidden version in selector if it's the current active version
Show hidden version in selector if it's the current active version
Release 3.0.0rc2
Release 3.0.0rc2 (#1607)
Render version and language selectors below the documentation's title (top left). This can be controlled via the new theme options version_selector and language_selector.
Release 3.0.0rc1
Release 3.0.0rc1 (#1597)
Added support for Sphinx 8.
Added support for Python 3.12.
Added support for docutils >0.18, <0.22.
Populate html_context with all the environment variables starting with READTHEDOCS_.
Drop support for Sphinx <6.0.
Drop support for Python <3.8.
analytics_id and analytics_anonymize_ip are deprecated, use sphinxcontrib-googleanalytics instead.
Drop support for all versions of Internet Explorer.
Raise a warning when defining html_theme_path. This was an old config that's not required anymore.
extra_css_files is deprecated and support will be removed in a future version.
Added flyout_display option to display the flyout attached (bottom of the sidebard) or hidden (default).
Added flyout_display option to display the flyout attached (bottom of the sidebard) or hidden (default).
Render the menu versions/languages selector (flyout) using the new readthedocs-addons-data-ready Read the Docs Addons CustomEvent.
Render the menu versions/languages selector (flyout) using the new readthedocs-addons-data-ready Read the Docs Addons CustomEvent.
Remove html5shiv.
The HTML4 writer is now officially deprecated. An error will be thrown if your project configuration still uses the HTML4 writer.
Support for Sphinx versions 6.x and 7.x
Support for docutils <=0.20
The HTML4 writer is now officially deprecated. An error will be thrown if your project configuration still uses the HTML4 writer.
Support for Sphinx versions < 5.0 was removed.
In addition, our supported dependencies will match the dependencies from our lowest supported Sphinx release, version 5.0: Python >= 3.6 and docutils > 0.14 and < 0.19
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Relaxed requirements to include Sphinx release 7.0
Relaxed requirements to include Sphinx release 7.0
Nothing published for this version
Require sphinxcontrib-jquery>=4,<5
Require sphinxcontrib-jquery>=4,<5 (#1446)
Styling for :menuselection: (#1426)
Nothing published for this version
Load jQuery correctly when using latest sphinxcontrib-jquery release
Load jQuery correctly when using latest sphinxcontrib-jquery release (#1448)
Added sphinxcontrib-jquery as a dependency (#1385 #1421)
docutils 0.18 is supported. (#1381)
Sphinx 6 support added
Added sphinxcontrib-jquery as a dependency (#1385 #1421)
Python 3.11 is officially supported and tested. (#1395)
Python 3.4 and 3.5 are officially not supported (#1395)
Automatically use sphinxcontrib-jquery in Sphinx 6+ (#1399)
Use new context vars logo_url, favicon_url and root_doc when available (#1405)
Translations updated: French, Hungarian, Croatian
Translations added: Danish, Chinese (Taiwan)
If you cannot use a more recent Sphinx release, you should at least ensure you are using the most recent release for your major version. Currently, these are Sphinx 1.8.6 and 2.4.5. Older releases may install unsupported versions of several dependencies, including Jinja2 and docutils.
In some cases, jQuery is not loaded with Sphinx 6 on Read the Docs. Workaround: You need to add sphinx_rtd_theme to extensions in your conf.py. See readthedocs.org issue #9654 for updates.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Fix wrapping bug on cross references
Fix wrapping bug on cross references (#1368)
Many documentation projects depend on sphinx-rtd-theme without specifying a version of the theme (unpinned) while also depending on unpinned versions
Many documentation projects depend on sphinx-rtd-theme without specifying a version of the theme (unpinned) while also depending on unpinned versions of Sphinx. The latest version of sphinx-rtd-theme ideally always supports the latest version of Sphinx, but this is now guaranteed.
This release adds upper bounds to direct dependencies Sphinx and docutils which will safeguard from mixing with possibly incompatible future versions of Sphinx & docutils.
Sphinx versions supported: 1.6 to 5.2.x
Sphinx<6 (#1332)
docutils<0.18 (unchanged, but will be bumped in an upcoming release)
Nicer styles for <kbd> (#967)
New styling for breadcrumbs (#1073)
Suffixes in Sphinx version caused build errors (#1345)
Table cells with multiple paragraphs gets wrong formatting (#289)
Definition lists rendered wrongly in api docs (#1052)
Citation not styled properly (#1078)
Long URLs did not wrap (#1193)
Sphinx 5.2 added to test matrix (#1348)
Python 3.10 added to test matrix (#1334)
Supplemental Docker setup for development (#1319)
Most of setup.py migrated to setup.cfg (#1116)
Jinja2 context variable sphinx_version_info is now (major, minor, -1), the patch component is always -1. Reason: It's complicated. (#1345)
There are no known incompatible changes in this release. Support for docutils versions 0.18 and 0.19 are scheduled for our next release.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Support for Sphinx's HTML4 writer is deprecated and will be removed in version 2.0
The minimum supported python version is now 2.7 or 3.4 and greater (#1093)
The minimum supported Sphinx version is now 1.6 (#1091)
Support for Sphinx's HTML4 writer is deprecated and will be removed in version 2.0 (#1091)
Add support for Sphinx 4.x (#1123)
Add support for Docutils 0.17 (#1185 and #1199)
Fixed logo scaling on IE11 (#1183)
Added support for logos as URLs (#1171)
Align top and side navigation background colors on mobile (#1132)
Added support for deep toc levels (#1089)
Updated translations for Chinese, Dutch, Estonian, French, German, Italian, Lithuanian, Persian, Polish, Portuguese, Russian, Spanish, Swedish, and Turkish locales
A number of accessibility features were added in this release:
Allow keyboard to toggle menu expansion (#1167)
Allow keyboard to activate permalink (#1162)
Show keyboard focus on buttons (#1161)
Maintain aria-expanded along with .current in menu (#1151)
Respect tab order for prev/next buttons (#1051)
Updated Google analytics integration (#1129)
Add classifier separation on Sphinx 2+ HTML4 writer (#1192)
Added missing space char in footer (#1188)
Fix navigation right padding on level2+ elements (#1068)
Fix navigation expansion button sizes (#1067)
Wrap inline literals (#1050)
Fix aria labels (#1056)
Don't toggle navigation terminal nodes (#1049)
Fix <pre> overflow (#1220)
Fix literal/ref style inside <dl> (#1088)
Update npm development dependencies (#1096)
Don't require npm to build from source (#1039)
Use regular toctree instead of toc for singlehtml builder (#507)
Cleanup whitespace in templates (#1060)
Nothing published for this version
.. note:: This commit will not be in master, but was branched directly off 0.5.1 to minimize issues. The next full release will contain all PR's previ
Note
This commit will not be in master, but was branched directly off 0.5.1 to minimize issues. The next full release will contain all PR's previously merged.
Depend on docutils < 0.17 (#1113)
The canonical_url option was deprecated in favor of Sphinx's html_baseurl
Set url_root properly on index (#1025)
Do not load language_data.js in non-search pages (#1021)
Hide the search box on any singlehtml like builder (#975)
Fix vcs_pageview_mode template parameter (#1010)
Mark nex/prev icons as aria-hidden (#1007)
Use well-formed XML syntax (#1006)
Footer: show both commit and last_updated if available (#897)
Search page: don't show "edit on" links (#935)
New theme option to enable anonymous ip addresses when using Google Analytics (#889)
The canonical_url option was deprecated in favor of Sphinx's html_baseurl (#1003)
Add contentinfo block to footer.html template (#896)
Make Copyright template match sphinx's basic (#933)
Packaging: include bin/preinstall.js (#1005)
Fix bullet list spacing to respect simple/complex list styles
Fix bullet list spacing to respect simple/complex list styles
Fix issue with simple definition lists that was missed
Fix issue with simple definition lists that was missed
Change FOUT back to FOIT
Fix several margin issues with lists, nested lists, and nested content
Add colon back to field lists
Fix many styling issues that look different when using the Sphinx HTML5 writer
Fix many styling issues that look different when using the Sphinx HTML5 writer
Add the navigation template block around the navigation area.
Added i18n support using Babel
Added translations for 10 new languages
Moved build system from Grunt and friends to Webpack
Remove Modernizr, but keep html5shiv (#724, #525)
Fix scrolling to active item in sidebar on load
Fix scrolling to active item in sidebar on load (#214)
Style caption link for code and literal blocks
Fix inconsistent font size and line height for autodoc "raises" and "returns" (#267)
Fix last_updated notice appearing in same line as copyright notice (#704)
Fix HTML search not working with Sphinx-1.8
Set base font size on <html> (#668)
Fix HTML search not working with Sphinx-1.8 (#672)
Upload signed packages to PyPI with twine (#651)
Do not enforce period at the end of copyright statement (666)
Line height adjustments for Liberation Mono
Line height adjustments for Liberation Mono (#656)
Add Sphinx as a dependency
This version made some changes to how JS and CSS were included when the theme is used on Read the Docs.
This version made some changes to how JS and CSS were included when the theme is used on Read the Docs.
Do not rely on readthedocs.org for CSS/JS (#614)
Color accessibility improvements on the left navigation
Write theme version and build date at top of JavaScript and CSS
Changed code and literals to use a native font stack (#612)
Fix small styling issues
Revert part of #576 causing display issues with version selector menu
Revert part of #576 causing display issues with version selector menu
Backwards compatibility fixes for pre-0.3.0 releases (#623)
Fix mkdocs version selector (#622)
Add open list spacing (#591)
Fix table centering (#599)
Note: this version resulted in some JavaScript incompatibilities when used on readthedocs.org
Note: this version resulted in some JavaScript incompatibilities when used on readthedocs.org
Add html language attribute
Allow setting 'rel' and 'title' attributes for stylesheets (#551)
Add option to style external links
Add github, gitlab, bitbucket page arguments option
Add pygments support
Add setuptools entry point allowing to use sphinx_rtd_theme as Sphinx html_theme directly.
Add language to the JS output variable
Fix some HTML warnings and errors
Fix many styling issues
Fix many sidebar glitches
Fix line number spacing to align with the code lines
Hide Edit links on auto created pages
Include missing font files with the theme
Significant improvement of our documentation
Compress our Javascript files
Updated dependencies
Nothing published for this version
Nothing published for this version
Yet another patch to deal with extra builders outside Spinx, such as the singlehtml builders from the Read the Docs Sphinx extension
Yet another patch to deal with extra builders outside Spinx, such as the singlehtml builders from the Read the Docs Sphinx extension
Temporarily patch Sphinx issue with singlehtml builder by inspecting the builder in template.
Temporarily patch Sphinx issue with singlehtml builder by inspecting the builder in template.
Roll back toctree fix in 0.2.1 (#367). This didn't fix the issue and introduced another bug with toctrees display.
Roll back toctree fix in 0.2.1 (#367). This didn't fix the issue and introduced another bug with toctrees display.
Add the rel HTML attribute to the footer links which point to the previous and next pages.
Add the rel HTML attribute to the footer links which point to the previous and next pages.
Fix toctree issue caused by Sphinx singlehtml builder (#367)
Adds the comments block after the body block in the template
Adds the comments block after the body block in the template
Added "Edit on GitLab" support
Many bug fixes
Nothing published for this version
.. note:: This is a pre-release version
Note
This is a pre-release version
Removes Sphinx dependency
Fixes hamburger on mobile display
Adds a body_begin block to the template
Added prev_next_buttons_location
Intermittent scrollbar visibility bug fixed. This change introduces a backwards incompatible change to the theme's layout HTML. This should only be a…
Intermittent scrollbar visibility bug fixed. This change introduces a backwards incompatible change to the theme's layout HTML. This should only be a problem for derivative themes that have overridden styling of nav elements using direct descendant selectors. See #215 for more information.
Safari overscroll bug fixed
Version added to the nav header
Revision id was added to the documentation footer if you are using RTD
An extra block, extrafooter was added to allow extra content in the document footer block
Fixed modernizr URL
Small display style changes on code blocks, figure captions, and nav elements
Support for third and fourth level headers in the sidebar
Start keeping changelog :)
Support for third and fourth level headers in the sidebar
Add support for Sphinx 1.3
Add sidebar headers for :caption: in Sphinx toctree
Clean up sidebar scrolling behavior so it never scrolls out of view
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →