Need help with vscode-custom-css?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

587 Stars 49 Forks MIT License 97 Commits 3 Opened issues


Custom CSS Plugin for Visual Studio Code. Based on vscode-icon

Services available


Need anything else?

Contributors list

Custom CSS and JS

SPECIAL NOTE: If Visual Studio Code complains about that it is corrupted, simply click “Don't show again”.

NOTE: Every time after Visual Studio Code is updated, please re-enable Custom CSS.

NOTE: Every time you change the configuration, please re-enable Custom CSS.

Starting from extension version 6.0, to be compatible with VSCode 1.58, the CSS/JS files being applied will be inlined into VSCode's workbench.

Custom CSS to your Visual Studio Code. Based on robertohuertasm’s vscode-icons.


Getting Started

  1. Install this extension.

  2. Add to

       "vscode_custom_css.imports": [""]


must be URLs. Plain file paths are NOT URLs.
  • Windows File URL Example:

    • The
      part is REQUIRED.
  • MacOS and Linux File URL Example:

  • See here for more details.

  1. Restart Visual Studio Code with proper permission to modify itself:

    1. Windows: Restart with Administrator Permission.
    2. MacOS and Linux: See instructions below.
  2. Activate command "Reload Custom CSS and JS".

  3. Restart.

Extension commands

As you know to access the command palette and introduce commands you can use F1 (all OSes), Ctrl+Shift+P (Windows & Linux) or Cmd+Shift+P (OS X).

  • Enable Custom CSS and JS: It enables custom CSS and JS URLs listed in “
    ”, an array containing URLs of your custom CSS and JS files, in your user settings.
  • Disable Custom CSS and JS: It will disable custom CSS.
  • Reload Custom CSS and JS: Disable and then re-enable it.

Windows users

In Windows, make sure you run your Visual Studio Code in Administrator mode before enabling or disabling your custom style!

Mac and Linux users

The extension would NOT work if Visual Studio Code cannot modify itself. The cases include:

  • Code files being read-only, like on a read-only file system or,
  • Code is not started with the permissions to modify itself.

You need to claim ownership on Visual Studio Code's installation directory, by running this command:

sudo chown -R $(whoami) 

The placeholder

 means the path to VSCode installation. It is typically:

  • /Applications/Visual Studio
    , on MacOS;
  • /Applications/Visual Studio Code -
    , on MacOS when using Insiders branch;
  • /usr/share/code
    , on most Linux;
  • /usr/lib/code/
    on Arch Linux.

Mac and Linux package managers may have customized installation path. Please double check your path is correct.


This extension modifies some Visual Studio Code files so use it at your own risk. Currently, icons are not supported by the extension functionality that Visual Studio Code provides so this extension solves this issue by injecting code into:

  • electron-browser/index.html

The extension will keep a copy of the original file in case something goes wrong. That's what the disable command will do for you.

As this extension modifies Visual Studio Code files, it will get disabled with every Visual Studio Code update. You will have to enable icons again via the command palette.

Take into account that this extension is still in beta, so you may find some bugs while playing with it. Please, report them to the issues section of the Github's repo.

Please, leave a review if you can, so the Visual Studio Code Team can know that this is a very demanded feature and, maybe, they can then provide a proper way to extend the IDE regarding icons and customizations soon enough. ;D

More file extensions will be supported shortly!

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.