Skip to main content

Themes

Themes let you customize Spotify's colors, fonts, and visual styling. From subtle tweaks to complete visual overhauls, themes are one of the most popular Spicetify features.

Installing Themes​

Via Marketplace​

The easiest way to install themes is through the Marketplace. Open Marketplace from Spotify's sidebar and browse the Themes tab.

Manual Installation​

For themes not in Marketplace:

  1. Download the theme folder (should contain color.ini and user.css)

  2. Place it in your Themes folder:

    PlatformPath
    Windows%appdata%\spicetify\Themes\
    Linux / macOS~/.config/spicetify/Themes/

  3. Apply the theme:

    spicetify config current_theme <theme-folder-name>
    spicetify apply

Color Schemes​

Many themes include multiple color schemes. To use a specific scheme:

spicetify config current_theme <theme-folder-name> color_scheme <scheme-name>
spicetify apply

Check the theme's color.ini file to see available schemes (each [SectionName] is a scheme).

Removing Themes​

To go back to Spotify's default appearance, set the theme to an empty value:

spicetify config current_theme ""
spicetify apply

Or set a different theme name.

Community Themes​

The Spicetify community has created many themes. Here are some popular repositories:

Official Repository​

The official collection, open for contributions:

ThemeDescription
ComfyComfortable, modern design
FluentWindows 11 Fluent Design style
CatppuccinSoothing pastel color palette
BloomGradient-heavy, vibrant look
LucidClean, minimal aesthetic
GruvifyGruvbox color scheme
Spotify DarkEnhanced dark theme
ThrowbackClassic Spotify look
SpicetifyCatCat-themed customization
RetroPlayerRetro aesthetic
Dracula (m0squdev)Dracula color palette

Unmaintained (May Not Work)​

These themes may not work with current Spotify versions:

Creating Themes​

Want to create your own theme? See the Theme Development Guide.

A basic theme needs two files:

  • color.ini: Color values that become CSS variables
  • user.css: Custom CSS rules

Example color.ini:

[Base]
main           = 121212
sidebar        = 000000
player         = 181818
card           = 282828
shadow         = 000000
selected-row   = 797979
button         = 1db954
button-active  = 1ed760
text           = ffffff
subtext        = b3b3b3

Troubleshooting​

Theme not applying​

  1. Make sure the theme folder name matches what you used in spicetify config
  2. Verify the folder contains both color.ini and user.css
  3. Run spicetify apply after any config changes

Theme looks broken after Spotify update​

After Spotify updates, themes may need adjustment. Try:

spicetify restore backup apply

If issues persist, check the theme's repository for updates or reported issues.

Colors not changing​

Make sure you're setting both the theme and color scheme:

spicetify config current_theme MyTheme color_scheme Dark
spicetify apply