# sphinx-rtd-theme

> Read the Docs theme for Sphinx

- **URL**: https://www.freshcrate.ai/projects/sphinx-rtd-theme
- **Author**: Dave Snider
- **Category**: Frameworks
- **Latest version**: `3.1.0` (2026-04-21)
- **License**: MIT
- **Source**: https://github.com/readthedocs/sphinx_rtd_theme/issues
- **Homepage**: https://github.com/readthedocs/sphinx_rtd_theme
- **Language**: Sass
- **GitHub**: 5,044 stars, 1,815 forks
- **Registry**: pypi (`sphinx-rtd-theme`)
- **Tags**: `pypi`

## Description

**************************
Read the Docs Sphinx Theme
**************************

.. image:: https://img.shields.io/pypi/v/sphinx_rtd_theme.svg
   :target: https://pypi.python.org/pypi/sphinx_rtd_theme
   :alt: Pypi Version
.. image:: https://circleci.com/gh/readthedocs/sphinx_rtd_theme.svg?style=svg
   :alt: Build Status
   :target: https://circleci.com/gh/readthedocs/sphinx_rtd_theme
.. image:: https://img.shields.io/pypi/l/sphinx_rtd_theme.svg
   :target: https://pypi.python.org/pypi/sphinx_rtd_theme/
   :alt: License
.. image:: https://readthedocs.org/projects/sphinx-rtd-theme/badge/?version=latest
  :target: http://sphinx-rtd-theme.readthedocs.io/en/latest/?badge=latest
  :alt: Documentation Status

This Sphinx_ theme was designed to provide a great reader experience for
documentation users on both desktop and mobile devices. This theme is used
primarily on `Read the Docs`_ but can work with any Sphinx project. You can find
a working demo of the theme in the `theme documentation`_

.. _Sphinx: http://www.sphinx-doc.org
.. _Read the Docs: http://www.readthedocs.org
.. _theme documentation: https://sphinx-rtd-theme.readthedocs.io/en/stable/

Installation
============

This theme is distributed on PyPI_ and can be installed with ``pip``:

.. code:: console

   $ pip install sphinx-rtd-theme

To use the theme in your Sphinx project, you will need to edit
your ``conf.py`` file's ``html_theme`` setting:

.. code:: python

    html_theme = "sphinx_rtd_theme"

.. admonition:: See also:

    `Supported browsers`_
        Officially supported and tested browser/operating system combinations

    `Supported dependencies`_
        Supported versions of Python, Sphinx, and other dependencies.

    `Example documentation`_
        A full example of this theme output, with localized strings enabled.

.. _PyPI: https://pypi.python.org/pypi/sphinx_rtd_theme
.. _Supported browsers: https://sphinx-rtd-theme.readthedocs.io/en/stable/development.html#supported-browsers
.. _Supported dependencies: https://sphinx-rtd-theme.readthedocs.io/en/stable/development.html#supported-dependencies
.. _Example documentation:  https://sphinx-rtd-theme.readthedocs.io/en/stable/

Configuration
=============

This theme is highly customizable on both the page level and on a global level.
To see all the possible configuration options, read the documentation on
`configuring the theme`_.

.. _configuring the theme: https://sphinx-rtd-theme.readthedocs.io/en/stable/configuring.html

Contributing
============

If you would like to help modify or translate the theme, you'll find more
information on contributing in our `contributing guide`_.

.. _contributing guide: https://sphinx-rtd-theme.readthedocs.io/en/stable/contributing.html

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `3.1.0` | 2026-04-21 | Low | Imported from PyPI (3.1.0) |
| `master@2026-01-12` | 2026-01-12 | Low | Latest activity on master branch |
| `master@2026-01-12` | 2026-01-12 | Low | Latest activity on master branch |
| `master@2026-01-12` | 2026-01-12 | Low | Latest activity on master branch |
| `master@2026-01-12` | 2026-01-12 | Low | Latest activity on master branch |
| `master@2026-01-12` | 2026-01-12 | Low | Latest activity on master branch |
| `master@2026-01-12` | 2026-01-12 | Low | Latest activity on master branch |
| `master@2026-01-12` | 2026-01-12 | Low | Latest activity on master branch |
| `master@2026-01-12` | 2026-01-12 | Low | Latest activity on master branch |
| `master@2026-01-12` | 2026-01-12 | Low | Latest activity on master branch |

## Citation

- HTML: https://www.freshcrate.ai/projects/sphinx-rtd-theme
- Markdown: https://www.freshcrate.ai/projects/sphinx-rtd-theme.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/sphinx-rtd-theme/deps

_Generated by freshcrate.ai. Indexes pypi releases for AI-agent ecosystem packages._