Hacking on the CSS of the Sphinx RTD's theme

First written on November 1, 2022

Read The Docs’ Sphinx theme (RTD) is quite good but there are some ways to improve it. Here are some useful CSS overrides I found. The Navbar and sidebar one I did it myself but it’s not fully functional.

Enable CSS override #

Add this content in your conf.py settings

html_static_path = ['_static']
html_css_files = ['css/custom.css']

Create a file in the static directory

touch _static/css/custom.css


Content width #

Increase content width. This is an problem for wide screens since you get too much unused space IMHO. Also, this issue seems to be a trend all over Internet.

See this StackOverflow question.

.wy-nav-content {
    max-width: 1536px !important;


1536px = (1024 + 512)px

Tables #

Responsive tables. See this GitHub issue.

/* Fix tables. */
.wy-table-responsive table td {
    white-space: normal;

Use the mobile bar for bigger resolutions. This makes the sidebar toggable with a button and the navbar fixed on top when scrolling a page.

A GitHub issue is currenly open for hiding the sidebar.

Unfortunately when I toggle the sidebar using my CSS code the page scrolls at the top because it points to a div or something. Moreover the page gets unscrollable until I toggle the sidebar again.

Hacking on the CSS
@media screen and (min-width:769px) {
    .wy-nav-top {
        display: block;
        position: sticky;
        top: 0;

    .wy-nav-side {
        left: -300px;

    .wy-nav-side.shift {
        width: 300px;
        left: 0;

    .wy-side-scroll {
        width: auto;

    .wy-nav-content-wrap {
        margin-left: 0;

    .wy-nav-content-wrap.shift {
        position: fixed;
        min-width: 100%;
        left: 300px;
        top: 0;
        height: 100%;

Hide the sidebar altogether. The problem with this approach is that you lose the search textbox.

See this GitHub issue.

.wy-nav-side {
    display: none;

.wy-nav-content-wrap {
  margin-left: 0;

Add or view comments