NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI
PyPI, #2865 most downloaded on PyPI
Bootstrap-based Sphinx theme from the PyData community
Latest stable
0.24.0
Last release 20 days ago
02 Nov 2026
Ships unpredictably
gaps range from 2 weeks to 1.3 years
Nearly every release is documented
notes for 48 of 52 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
75 releases · first in 2020
Drag across the ruler to compare, or tap a release to open it.
If you target a fontawesome icon with a svg CSS selector in your custom styles, use i instead, because s are not getting turned into s at page load an
If you target a fontawesome icon with a svg CSS selector in your custom styles, use i instead, because <i>s are not getting turned into <svg>s at page load anymore per https://github.com/pydata/pydata-sphinx-theme/pull/2494.
This does not apply to custom icons, only built-in fontawesome icons.
e.g., your custom CSS rule svg.fa-foo { ... } must become i.fa-foo { ... } (or just .fa-foo { ... }) to be compatible with this release.
More details: https://pydata-sphinx-theme.readthedocs.io/en/latest/user_guide/fonts.html#fonts-and-fontawesome
Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.23.0...v0.24.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
If you target a fontawesome icon with a svg CSS selector in your custom styles, use i instead. This does not apply to custom icons, only built-in font
svg CSS selector in your custom styles, use i instead. This does not apply to custom icons, only built-in fontawesome iconsFull Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.23.0...v0.24.0rc0
Loosen what keys can be cached in the sidebar by @Yann-P in https://github.com/pydata/pydata-sphinx-theme/pull/2500
Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.22.0...v0.23.0
Loosen what keys can be cached in the sidebar by @Yann-P in https://github.com/pydata/pydata-sphinx-theme/pull/2500
Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.22.0...v0.23.0rc0
fix a console error when pstAnnouncementUrl is undefined by @bollwyvl in https://github.com/pydata/pydata-sphinx-theme/pull/2481
Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.21.0...v0.22.0
Add a configuration option for which templates to skip empty checks by @Cadair in https://github.com/pydata/pydata-sphinx-theme/pull/2477
None
Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.21.0...v0.22.0rc0
Fix navbar rendering for special pages in toctree by @medmunds in https://github.com/pydata/pydata-sphinx-theme/pull/2447
None.
Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.20.0...v0.21.0
Drop Sphinx <= 8.1, Python <= 3.10 by @Yann-P in https://github.com/pydata/pydata-sphinx-theme/pull/2412
Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.19.0...v0.20.0
Bump pydata/pydata-sphinx-theme/.github/workflows/CI.yml from 178df7a9d69695be4e49fa56822d76b048977387 to 047227ad41f26a993ea7b2182955d26aa837acea by
Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.18.0...v0.19.0
De-jumble header items at intermediate widths :) by @sneakers-the-rat in https://github.com/pydata/pydata-sphinx-theme/pull/1784
Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.18.0...v0.19.0rc0
Drop support for sphinx 7, minimal requirement now 8 by @Yann-P in https://github.com/pydata/pydata-sphinx-theme/pull/2366
sticky_banners)sticky_banners by @agriyakhetarpal in https://github.com/pydata/pydata-sphinx-theme/pull/2385Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.17.1...v0.18.0
Fix theme dropdown menu going offscreen by @hntk03 in https://github.com/pydata/pydata-sphinx-theme/pull/2387
sticky_banners by @agriyakhetarpal in https://github.com/pydata/pydata-sphinx-theme/pull/2385Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.18.0rc1...v0.18.0rc2
Update internal CI action pin for tests by @Yann-P in https://github.com/pydata/pydata-sphinx-theme/pull/2382
Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.18.0rc0...v0.18.0rc1
Fix docs build with sphinx 'extensions' config key by @Yann-P in https://github.com/pydata/pydata-sphinx-theme/pull/2352
Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.17.0...v0.17.1
BUG - Add --pst-color-heading fallback by @trallard in https://github.com/pydata/pydata-sphinx-theme/pull/2082
--pst-color-heading fallback by @trallard in https://github.com/pydata/pydata-sphinx-theme/pull/2082scroll-behavior: smooth to improve UX by @lagru in https://github.com/pydata/pydata-sphinx-theme/pull/2261Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.16.1...v0.17.0
Stop moving the Read the Docs version switcher into the sidebar by @gabalafou in https://github.com/pydata/pydata-sphinx-theme/pull/2034
sidebarwidth in config file by @Carreau in https://github.com/pydata/pydata-sphinx-theme/pull/2031Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.16.0...v0.16.1
Stop moving the Read the Docs version switcher into the sidebar by @gabalafou in https://github.com/pydata/pydata-sphinx-theme/pull/2034
sidebarwidth in config file by @Carreau in https://github.com/pydata/pydata-sphinx-theme/pull/2031Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.16.0...v0.16.1rc0
Scrollable table? Make keyboard accessible (focusable) by @gabalafou in https://github.com/pydata/pydata-sphinx-theme/pull/1903
Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.15.4...v0.16.0
BUG: Ensure coverage comment is properly triggered by @trallard in https://github.com/pydata/pydata-sphinx-theme/pull/1901
Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.15.4...v0.16.0rc0
Inheritance Diagram Dark Mode Support by @j9ac9k in https://github.com/pydata/pydata-sphinx-theme/pull/1834
Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.15.3...v0.15.4
Inheritance Diagram Dark Mode Support by @j9ac9k in https://github.com/pydata/pydata-sphinx-theme/pull/1834
Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.15.3...v0.15.4rc0
remove deprecated configs and associated code/tests by @drammock in https://github.com/pydata/pydata-sphinx-theme/pull/1698
<pre>) are keyboard focusable by @gabalafou in https://github.com/pydata/pydata-sphinx-theme/pull/1636Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.15.2...v0.15.3
remove deprecated configs and associated code/tests by @drammock in https://github.com/pydata/pydata-sphinx-theme/pull/1698
Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.15.2...v0.15.3rc1
Align the search button with other icons by @12rambau in https://github.com/pydata/pydata-sphinx-theme/pull/1620
Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.15.1...v0.15.2
fix: drop the dev test by @12rambau in https://github.com/pydata/pydata-sphinx-theme/pull/1623
Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.15.0...v0.15.1
fix: install pandoc in the a11y tests by @12rambau in https://github.com/pydata/pydata-sphinx-theme/pull/1576
Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.14.4...v0.15.0rc0
docs: add the list of component using a directive by @12rambau in https://github.com/pydata/pydata-sphinx-theme/pull/1476
Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.14.3...v0.14.4
kill the docs-live infinite loop (yet again) by @drammock in https://github.com/pydata/pydata-sphinx-theme/pull/1540
Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.14.2...v0.14.3
chore: build the devcontainer automatically in codespace by @12rambau in https://github.com/pydata/pydata-sphinx-theme/pull/1483
Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.14.1...v0.14.2
fix: change the z-index of the dropdown by @12rambau in https://github.com/pydata/pydata-sphinx-theme/pull/1442
Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.14.0...v0.14.1
MAINT: deprecations by @drammock in https://github.com/pydata/pydata-sphinx-theme/pull/1381
id & href attributes for API documentation by @bheberlein in https://github.com/pydata/pydata-sphinx-theme/pull/1208sphinx.testing.path on Sphinx 7.1 and earlier by @AA-Turner in https://github.com/pydata/pydata-sphinx-theme/pull/1405Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.13.3...v0.14.0
refactor: spring cleaning by @12rambau in https://github.com/pydata/pydata-sphinx-theme/pull/1271
Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.13.2...v0.13.3
Fix broken Sphinx link in footer by @vkbo in https://github.com/pydata/pydata-sphinx-theme/pull/1234
Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.13.1...v0.13.2
fix: deprecate use of the favicon config parameter by @12rambau in https://github.com/pydata/pydata-sphinx-theme/pull/1225
<p> from announcement sample text by @choldgraf in https://github.com/pydata/pydata-sphinx-theme/pull/1223<p> in docs for realz by @choldgraf in https://github.com/pydata/pydata-sphinx-theme/pull/1224Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.13.0...v0.13.1
FIX: Use logo_url instead deprecated logo in theme (#1094) by @nicoa in https://github.com/pydata/pydata-sphinx-theme/pull/1097
Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.12.0...v0.13.0
See: https://github.com/pydata/pydata-sphinx-theme/releases/tag/v0.13.0rc3
See: https://github.com/pydata/pydata-sphinx-theme/releases/tag/v0.13.0rc3
See: https://github.com/pydata/pydata-sphinx-theme/releases/tag/v0.13.0rc3
See: https://github.com/pydata/pydata-sphinx-theme/releases/tag/v0.13.0rc3
See RC3 changelog for a running changelog
See RC3 changelog for a running changelog
FIX: Use logo_url instead deprecated logo in theme (#1094) #1097 (@nicoa)
start and end #1184 (@choldgraf)FIX: Narrow scope of style rule for GitHub & GitLab link shortening #1167 (@bheberlein)
FIX: Javascript incorrect check for variable #1166 (@choldgraf)
FIX: Flex behavior should shrink header items instead of brand #1158 (@bheberlein)
FIX: Center search keyboard buttons #1103 (@choldgraf)
FIX: Use logo_url instead deprecated logo in theme (#1094) #1097 (@nicoa)
FIX: Blog tag cloud overflow #1093 (@choldgraf)
Fix article header CSS #1171 (@choldgraf)
Fix header vertical spacing and jupyter-sphinx cells #1164 (@choldgraf)
Copyright semicolon #1160 (@choldgraf)
fix: align sidebar sliding with the buttons #1123 (@12rambau)
Fix extra whitespace in sidebars #1115 (@choldgraf)
Properly handle default_mode=auto when writing logos #1183 (@lunar-debian)
Fixing header height #1102 (@choldgraf)
drop prettify to avoid extra space in inline block #1101 (@12rambau)
make accessible-pygments a full dependency #1083 (@drammock)
(GitHub contributors page for this release)
@12rambau @2bndy5 @AA @benjaoming @bheberlein @choldgraf @dependabot @dixong @drammock @jarrodmillman @jeanas @jorisvandenbossche @lunar @mathbunnyru @nicoa @prjemian @rossbar @timhoffm @trallard @tupui @VincentRouvreau
Nothing published for this version
FIX: Use logo_url instead deprecated logo in theme (#1094) #1097 (@nicoa)
pip install --pre pydata-sphinx-theme
(GitHub contributors page for this release)
@12rambau @2bndy5 @AA @benjaoming @choldgraf @dependabot @dixong @drammock @jarrodmillman @jorisvandenbossche @mathbunnyru @nicoa @prjemian @rossbar @timhoffm @trallard @tupui
fix: remove deprecated config by @12rambau in https://github.com/pydata/pydata-sphinx-theme/pull/997
Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.11.0...v0.12.0
Rename and add deprecation warnings for section names by @12rambau in https://github.com/pydata/pydata-sphinx-theme/pull/988
Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.11.0...v0.12.0rc1
Correct the link to the pygments styles in styling.rst by @braxtons12 in https://github.com/pydata/pydata-sphinx-theme/pull/910
Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.10.1...v0.11.0
Support Sphinx 4.2+ by @jarrodmillman in https://github.com/pydata/pydata-sphinx-theme/pull/978
Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.11.0rc2...v0.11.0rc3
Fix for publishing prereleases by @jarrodmillman in https://github.com/pydata/pydata-sphinx-theme/pull/974
Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.11.0rc1...v0.11.0rc2
Don't test against prereleased dependecies by @jarrodmillman in https://github.com/pydata/pydata-sphinx-theme/pull/900
Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.10.0...v0.10.1
DOC: Add comment to deprecate some CSS in future #848 (@drammock)
(GitHub contributors page for this release)
@12rambau | @choldgraf | @dependabot | @drammock | @tupui
Discussion here: https://github.com/pydata/pydata-sphinx-theme/discussions/814
Discussion here: https://github.com/pydata/pydata-sphinx-theme/discussions/814
Below is a list of people that contributed discussion, new ideas, code and documentation, and review of one another's work.
(GitHub contributors page for this release)
@12rambau | @bollwyvl | @bryevdv | @choldgraf | @chrisjsewell | @damianavila | @dopplershift | @drammock | @gilbertbw | @greschd | @jarrodmillman | @jorisvandenbossche | @jpmckinney | @kinow | @lwasser | @martinRenou | @melund | @mgeier | @mwaskom | @oscargus | @QuLogic | @solegalli | @tupui
Add deprecation warning for switcher by @choldgraf in https://github.com/pydata/pydata-sphinx-theme/pull/655
activeVersion and activeVersionName values by @tupui in https://github.com/pydata/pydata-sphinx-theme/pull/654Full Changelog: https://github.com/pydata/pydata-sphinx-theme/compare/v0.8.1...v0.9.0
Add deprecation warning for switcher #655 (@choldgraf)
activeVersion and activeVersionName values #654 (@tupui)(GitHub contributors page for this release)
@12rambau | @AdamRJensen | @albig | @choldgraf | @damianavila | @djhoese | @flying-sheep | @HealthyPear | @hoetmaaiers | @jarrodmillman | @jorisvandenbossche | @larsoner | @maximlt | @melissawm | @pradyunsg | @tupui
ref: #575 (@tupui) | #604 (@choldgraf)
ref: #594 (@AakashGfude)
ref: #575 (@tupui) | #604 (@choldgraf)
The version switcher dropdown now uses a hard-coded URL for each version. This results in less brittle/breaking behavior over time, especially if you want to change the URL structure of old versions.
# by default, and have nicer hovering behavior. ref: #593 (@choldgraf)This release brings in a number of new UI improvements and CSS bugfixes. It cleans up the layout of the site a bit more and gives you more customizabi
This release brings in a number of new UI improvements and CSS bugfixes. It cleans up the layout of the site a bit more and gives you more customizability over several elements. In addition, we've done an overhaul of our contributing and demo site documentation.
(GitHub contributors page for this release)
@12rambau | @astrojuanlu | @bollwyvl | @bryevdv | @choldgraf | @damianavila | @dopplershift | @drammock | @greglucas | @jbednar | @jorisvandenbossche | @larsoner | @mattip | @MegChai | @OriolAbril | @pradyunsg | @rgommers | @ThuWangzw | @tupui | @yhuang85
This is a patch release that includes a fix for compatibility with sphinx 4.3.
This is a patch release that includes a fix for compatibility with sphinx 4.3.
This is a patch release that includes a fix for translations in the "previous" and "next" buttons.
This is a patch release that includes a fix for translations in the "previous" and "next" buttons.
Fixing admonition title CSS #407 (@choldgraf)
(GitHub contributors page for this release)
@12rambau | @ajschmidt8 | @akaszynski | @akhmerov | @astrojuanlu | @bollwyvl | @choldgraf | @chrisjsewell | @dependabot | @drammock | @erogluorhan | @greglucas | @hoetmaaiers | @isabela-pf | @jackminchin | @jorisvandenbossche | @jpmckinney | @lwasser | @MegChai | @mwaskom | @pradyunsg | @romanlutz | @rossbar | @scottyhq | @SebastianJL | @timhoffm | @tupui | @yhuang85
Fix regression with 'None' inserted in html by google analytics script #404
Fixes a compatibility issue with the latest jinja2 version.
Fixes a compatibility issue with the latest jinja2 version.
(GitHub contributors page for this release)
@choldgraf | @drammock | @FabioRosado | @jorisvandenbossche | @jpmckinney | @rossbar
Add NetworkX to the list of projects using the theme #390 (@jarrodmillman)
user-select bug for safari #380 (@V0lantis)(GitHub contributors page for this release)
@choldgraf | @drammock | @jarrodmillman | @jorisvandenbossche | @V0lantis
✨ ENH: Scroll to active page in navigation left sidebar #363 (@jorisvandenbossche)
(GitHub contributors page for this release)
@bollwyvl | @bryevdv | @choldgraf | @dependabot | @drammock | @jorisvandenbossche | @MegChai | @tcmetzger | @tupui
One column per quarter.