The PyData Sphinx Theme
A clean, three-column, Bootstrap-based Sphinx theme by and for the PyData community.
- :books: Documentation: https://pydata-sphinx-theme.readthedocs.io/en/stable
- :bulb: Examples: https://pydata-sphinx-theme.readthedocs.io/en/stable/examples
- :raised_hands: Contribute: https://pydata-sphinx-theme.readthedocs.io/en/stable/community
- :globe_with_meridians: Translate: https://explore.transifex.com/12rambau/pydata-sphinx-theme/
Installation and usage
The theme is available on PyPI and conda-forge. You can install and use as follows:
-
Install the
pydata-sphinx-themein your doc build environment:pip install pydata-sphinx-theme # or conda install pydata-sphinx-theme --channel conda-forge
-
Then, in the
conf.pyof your sphinx docs, you update thehtml_themeconfiguration option:html_theme = "pydata_sphinx_theme"
And that's it!
[!NOTE] This theme may not work with the latest major versions of Sphinx, especially if they have only recently been released. Please give us a few months of time to work out any bugs and changes when new releases are made. See our contributing documentation for more information.
Contribute to and develop the theme
Contributions are very welcome! Installing the development version, building
the example docs and developing the CSS/JS of the theme, etc., is explained in
more detail in the contributing section of the documentation:
4 maintainers
Release files for pydata-sphinx-theme 0.21.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pydata_sphinx_theme-0.21.0.tar.gz | 5.0 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pydata_sphinx_theme-0.21.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size:11.2 MB
Release files / pydata_sphinx_theme-0.21.0.tar.gz
| Download URL | pydata_sphinx_theme-0.21.0.tar.gz |
|---|---|
| Size | 5.0 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
dc3f71216ea34725ddad68e505497eab4ba134a88abfb971a7df6b28a35c1997
|
|
BLAKE2b-256 checksum How to use checksums |
bdac692035c97b732b26ee269fb14ec790046b21c7383a46bedfb3d40c3a4884
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 25, 2026.
Transparency logRelease files / pydata_sphinx_theme-0.21.0-py3-none-any.whl
| Download URL | pydata_sphinx_theme-0.21.0-py3-none-any.whl |
|---|---|
| Size | 6.2 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d36a754bf9580b01789efa8a01869f2d7c87fa6c543ecbcafb14b6bdd4364f90
|
|
BLAKE2b-256 checksum How to use checksums |
b58dfb90c2ada1a938ba55f1730139f4d43736aee22d5f82f927c64cd858256f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 25, 2026.
Transparency log
