NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #2863 most downloaded on PyPI
Bootstrap-based Sphinx theme from the PyData community
Last release 5 days ago
29 Sep 2026
Ships unpredictably
gaps range from 2 weeks to 1.3 years
Nearly every release is documented
notes for 46 of 50 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
72 releases · first in 2020
One column per quarter.
Loosen what keys can be cached in the sidebar by @Yann-P in #2500
Full Changelog: v0.22.0...v0.23.0rc0
fix a console error when pstAnnouncementUrl is undefined by @bollwyvl in #2481
Full Changelog: v0.21.0...v0.22.0
Add a configuration option for which templates to skip empty checks by @Cadair in #2477
None
Full Changelog: v0.21.0...v0.22.0rc0
Fix navbar rendering for special pages in toctree by @medmunds in #2447
None.
Full Changelog: v0.20.0...v0.21.0
Drop Sphinx <= 8.1, Python <= 3.10 by @Yann-P in #2412
Full Changelog: v0.19.0...v0.20.0
Bump pydata/pydata-sphinx-theme/.github/workflows/CI.yml from 178df7a to 047227a by @dependabot [bot] in #2398
Full Changelog: v0.18.0...v0.19.0
De-jumble header items at intermediate widths :) by @sneakers-the-rat in #1784
Full Changelog: v0.18.0...v0.19.0rc0
Drop support for sphinx 7, minimal requirement now 8 by @Yann-P in #2366
sticky_banners)sticky_banners by @agriyakhetarpal in #2385Full Changelog: v0.17.1...v0.18.0
Fix theme dropdown menu going offscreen by @hntk03 in #2387
sticky_banners by @agriyakhetarpal in #2385Full Changelog: v0.18.0rc1...v0.18.0rc2
Update internal CI action pin for tests by @Yann-P in #2382
Full Changelog: v0.18.0rc0...v0.18.0rc1
Fix docs build with sphinx 'extensions' config key by @Yann-P in #2352
Full Changelog: v0.17.0...v0.17.1
BUG - Add --pst-color-heading fallback by @trallard in #2082
--pst-color-heading fallback by @trallard in #2082Note truncated.
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
Fix AttributeError("'NoneType' object has no attribute 'get'") when including TOC #347 (@tpajurek-dtml)
Fix deadlink to Fairlearn docs #344 (@kmaehashi)
MAINT: Work around Sphinx deprecation #301 (@larsoner)
--pst-header-height CSS variable.navbar_align (controlling the left/right/center alignment of the navigation links in the navbar), logo_link (if your logo should link to a different page as the main sphinx index page), icon_links (for custom icon links on the right side of the navbar). See the configuration user guide for all options.<dt> anchor links #280 (@hoetmaaiers)(GitHub contributors page for this release)
@12rambau | @aterrel | @bollwyvl | @bryevdv | @CAM-Gerlach | @choldgraf | @CodeCox | @dependabot | @djhoese | @drammock | @eric-wieser | @hoetmaaiers | @jorisvandenbossche | @larsoner | @leonarduschen | @mattip | @MegChai | @mgeier | @mwaskom | @pgjones | @pradyunsg | @riedgar-ms | @TheRajatSethi
Your coding agent can read these notes before it upgrades. Set up the MCP server →