Support & FAQ

Repair your Vencord installation:

• Discord Desktop: Run the Installer and choose “Repair”
• Vesktop: Right click the Vesktop tray icon and choose “Repair Vencord”. You can also run vesktop --repair if you prefer using the command line or have no tray.
• Web: Remove the Vencord extension and reinstall it from the extension store. You won’t lose your settings or data.

⚠️ Warning: This will remove all your local Discord data and log you out.

1. Do a clean reinstall of Discord
   • Windows
   • macOS
   • Linux: Delete ~/.config/discord
2. Launch Discord
3. Try installing again

This is usually caused by network issues or DNS problems on your system. Try the following steps one by one to resolve the issue.

1. Try changing your DNS server

DNS servers help translate domain names (github.com) into IP addresses (140.82.121.3). By default you are probably using your ISP’s DNS server, who sometimes may be unreliable or deliberately block certain websites like GitHub.

We recommend switching to a reliable DNS server like Cloudflare’s 1.1.1.1:

• Windows
• macOS
• Linux

2. Check your hosts file

The hosts file contains mappings of IP addresses to hostnames and can be used to override DNS settings for specific domains. The file is located at

• Windows: C:\Windows\System32\drivers\etc\hosts
• macOS / Linux: /etc/hosts

Open it with a text editor with administrative privileges (e.g., Notepad on Windows, sudo nano on macOS/Linux). Look for any entries that contain github and remove them.

If you found any entries containing github, save the file and restart your system for the changes to take effect.

3. Use a VPN

Some isps may block access to GitHub. You can try using a VPN to bypass these restrictions.

You can use ProtonVPN for free: https://protonvpn.com/free-vpn

If you are getting the error tls: failed to verify certificate: x509: certificate signed by unknown authority

You have custom SSL certificates installed on your system which are causing this issue. This is usually because you used cracked software or development tools that installed their own certificates.

To resolve this:

1. Press Win + R to open the Run prompt
2. Type certmgr.msc and hit enter to open the Certificate manager
3. Under Personal > Certificates, delete any certificates that you are sure you won’t need anymore. If you are unsure, ask AI or ask for help in our support channel. Deleting the wrong certificates can prevent certain applications from working correctly.

The most common cause of lag are poorly written themes or CSS.

1. In Settings > Themes: Disable all your themes. If you have online themes, remove those too.
2. In Settings > Vencord: Disable “Enable Custom CSS”
3. If the lag is fixed, that means one of your themes or your custom CSS was causing the issue. You can then re-enable them one by one to identify the culprit.

1. Open the browser developer tools with CTRL + Shift + i (Cmd + Option + i on MacOs)
2. Click on the “Console” tab at the top of the developer tools
3. Type allow pasting and press Enter. If you get an error, just ignore it and proceed to the next step
4. Paste the following code into the console and press Enter

(() => {
    Vencord.Settings.useQuickCss = false
    try {
        const copy = window.copy ?? Vencord.Util.copyToClipboard
        copy(Vencord.Settings.themeLinks.join("\n"))
    } catch { }
    Vencord.Settings.themeLinks = []
    Vencord.Settings.enabledThemes = []
})()

It will

• disable custom css — You can turn it back on in Vencord Settings
• copy your current theme links to your clipboard as a backup
• remove all themes

We provide a convenient graphical installer you can use. Or you can just grab Vencord from the Chrome Webstore or via Userscript.

Visit our download page to find out more!

Yes! We provide extensions for Chromium based browsers and a Userscript.

See our download page for more info!

Vencord only supports Desktop.

Instead, we recommend the following alternatives for mobile:

• Aliucord (discord server) ~ Android only. Uses the old (mid-2022) version of the Discord Android app
• Revenge (discord server) ~ Android only. Uses the latest Discord mobile app
• Kettu (discord server) ~ Android & iOS. Uses the latest Discord mobile app

You can’t. But chances are, it’s already a Vencord plugin!

Client modifications are against Discord’s Terms of Service.

However, Discord is pretty indifferent about them and there are no known cases of users getting banned for using client mods! So you should generally be fine as long as you don’t use any plugins that implement abusive behaviour. But no worries, all inbuilt plugins are safe to use!

Regardless, if your account is very important to you and it getting disabled would be a disaster for you, you should probably not use any client mods (not exclusive to Vencord), just to be safe

Additionally, make sure not to post screenshots with Vencord in a server where you might get banned for it

Settings are already shared across all Discord instances on the same PC so you can just switch and they will be kept!

Vencord is uninstalled the same way you install it. Just use the “Uninstall” button instead

The only official websites are vencord.dev and vesktop.dev. Any other website claiming to be an official Vencord website is likely malicious.

If you have downloaded software offered by an unofficial site, remove it as soon as possible, run a malware scan, reinstall Discord, and change your password. Also, if possible, dispatch an intercontinental ballistic missile to your hard drive for good measure.