Skip to content
Switch branches/tags

Latest commit

* Fix support for logos as urls

Sphinx since 4.0 appears to support html_logo to also contain urls.  As
a consequence, the other themes in sphinx appear to be just using the
new logo_url variable, and in this theme that fixes support for it, too.

* Add backwards compatibility and add favicon_url

Co-authored-by: Aaron Carlisle <>

Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Read the Docs Sphinx Theme

Pypi Version Build Status License 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


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

$ pip install sphinx-rtd-theme

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

html_theme = "sphinx_rtd_theme"

For more information, including a full example with localized strings enabled, read the documentation on installing the theme.


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.


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