Home / Installation Guide

How to Install Discord & Vencord Themes

Detailed step-by-step instructions to load custom .theme.css files on Vencord, Vesktop, and BetterDiscord across Windows, macOS, and Linux.

⚡ Method 1: Installing on Vencord (Recommended)

Vencord is the fastest, lightest client mod for Discord. Themes load instantaneously without performance loss.

  1. Download your theme: Click the .theme.css download button on any card in the CordThemes Catalog.
  2. Open Discord Settings: Click the gear icon in the bottom-left corner of Discord.
  3. Navigate to Themes: Scroll down the left sidebar to the Vencord section and select Themes.
  4. Open the Themes Folder: Click the "Open Themes Folder" button at the top of the settings page.
    %appdata%\Vencord\themes
  5. Place the file: Drag and drop your downloaded .theme.css file into the folder.
  6. Enable: Return to Discord. Your new theme will appear in the list. Flip the toggle switch to ON. Done!

🎨 Method 2: Installing on BetterDiscord

  1. Open Discord User Settings (Gear icon).
  2. Under BetterDiscord in the sidebar, click on Themes.
  3. Click Open Themes Folder at the top.
    %appdata%\BetterDiscord\themes
  4. Move your .theme.css into that directory and toggle it on in Discord.

Themes Folder Paths by Operating System

Windows (Vencord):
%appdata%\Vencord\themes
macOS (Vencord):
~/Library/Application Support/Vencord/themes
Linux / Vesktop:
~/.config/vesktop/themes or ~/.config/Vencord/themes

Troubleshooting Common Issues

1. Theme is not showing up in the list?

Make sure the file extension ends in exactly .theme.css (not .css.txt). In Windows File Explorer, ensure "File name extensions" is checked in the View tab.

2. Background image is blank or not loading?

Verify that your image URL is a direct link ending in .png, .jpg, .jpeg, or .webp. When using Catbox.moe, make sure you copy the link starting with https://files.catbox.moe/....

3. Discord updated and broke the theme?

Simply re-run the Vencord installer to patch the latest Discord update, or download updated themes from CordThemes.