Customizing the theme icon for Quarto websites

A quick-and-dirty guide
quarto
webdev
Author

Luke

Published

June 15, 2025

In Quarto websites you can specify more than one theme, like so:

format:
  html:
    theme:  
      dark: darkly
      light: morph

If you define your light and dark theme in this way, the rendered website will have a switch icon in the navbar.

The icon this theme toggle uses by default is too abstract for my taste.

The default theme switcher icon

The default theme switcher icon

I definitely prefer the more commonly used sun and moon icons, so I set out to find a way to replace this icon.

Naturally, I first tried to find other people who wanted to replace this. I found one GitHub Issue thread where people were discussing different ways of going about it, but it didn’t seem like anyone had a complete solution quite yet.

After a lot of experimenting, I found a way that works for me. Funnily, it’s pretty similar to what was discussed in the thread, as what I arrived on is basically a mix of two of the pre-existing answers.

.quarto-color-scheme-toggle {
  margin-right: 8px !important;
}

.quarto-color-scheme-toggle:not(.alternate) .bi::before {
  background-image: url('data:image/svg+xml,<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="%234a5568" class="bi bi-moon-stars-fill" viewBox="0 0 16 16"><path d="M6 .278a.768.768 0 0 1 .08.858 7.208 7.208 0 0 0-.878 3.46c0 4.021 3.278 7.277 7.318 7.277.527 0 1.04-.055 1.533-.16a.787.787 0 0 1 .81.316.733.733 0 0 1-.031.893A8.349 8.349 0 0 1 8.344 16C3.734 16 0 12.286 0 7.71 0 4.266 2.114 1.312 5.124.06A.752.752 0 0 1 6 .278z"/><path d="M10.794 3.148a.217.217 0 0 1 .412 0l.387 1.162c.173.518.579.924 1.097 1.097l1.162.387a.217.217 0 0 1 0 .412l-1.162.387a1.734 1.734 0 0 0-1.097 1.097l-.387 1.162a.217.217 0 0 1-.412 0l-.387-1.162A1.734 1.734 0 0 0 9.31 6.593l-1.162-.387a.217.217 0 0 1 0-.412l1.162-.387a1.734 1.734 0 0 0 1.097-1.097l.387-1.162zM13.863.099a.145.145 0 0 1 .274 0l.258.774c.115.346.386.617.732.732l.774.258a.145.145 0 0 1 0 .274l-.774.258a1.156 1.156 0 0 0-.732.732l-.258.774a.145.145 0 0 1-.274 0l-.258-.774a1.156 1.156 0 0 0-.732-.732l-.774-.258a.145.145 0 0 1 0-.274l.774-.258c.346-.115.617-.386.732-.732L13.863.1z"/></svg>') !important;
}

body.quarto-dark .quarto-color-scheme-toggle > .bi::before {
  background-image: url('data:image/svg+xml,<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="%23d1d5db" class="bi bi-sun-fill" viewBox="0 0 16 16"><path d="M8 12a4 4 0 1 0 0-8 4 4 0 0 0 0 8zM8 0a.5.5 0 0 1 .5.5v2a.5.5 0 0 1-1 0v-2A.5.5 0 0 1 8 0zm0 13a.5.5 0 0 1 .5.5v2a.5.5 0 0 1-1 0v-2A.5.5 0 0 1 8 13zm8-5a.5.5 0 0 1-.5.5h-2a.5.5 0 0 1 0-1h2a.5.5 0 0 1 .5.5zM3 8a.5.5 0 0 1-.5.5h-2a.5.5 0 0 1 0-1h2A.5.5 0 0 1 3 8zm10.657-5.657a.5.5 0 0 1 0 .707l-1.414 1.414a.5.5 0 1 1-.707-.707l1.414-1.414a.5.5 0 0 1 .707 0zm-9.193 9.193a.5.5 0 0 1 0 .707L3.05 13.657a.5.5 0 0 1-.707-.707l1.414-1.414a.5.5 0 0 1 .707 0zm9.193 2.121a.5.5 0 0 1-.707 0l-1.414-1.414a.5.5 0 0 1 .707-.707l1.414 1.414a.5.5 0 0 1 0 .707zM4.464 4.465a.5.5 0 0 1-.707 0L2.343 3.05a.5.5 0 1 1 .707-.707l1.414 1.414a.5.5 0 0 1 0 .707z"/></svg>') !important;
}

I’m basically just loading icons from the built-in bootstrap icon set, filling them with a color from each of my themes, and targeting the CSS of the toggle. I also added a bit of space so that the icon is not right next to the search button.

The part that took me some trial and error was that the dark mode icon is selected slightly differently than the light mode one. Also, in both cases I use the before pseudo-element so that I can inject these elements without modifying the HTML.

This works pretty well as I hope you can see from this site!

So in case you were also looking to change the icon, feel free to use/modify the above. Should it be broken by the time you read this, you can always check my source files :)