Skip to content

Installing Cascadia Code

Jump to bottom
Aaron edited this page Sep 16, 2020 · 22 revisions

You can download a zip containing the latest version of Cascadia Code from the releases page here: https://github.com/microsoft/cascadia-code/releases

The variants contained within are:

  • Cascadia Code: standard version of Cascadia
  • Cascadia Mono: version of Cascadia that doesn't have ligatures
  • Cascadia (Code|Mono) PL: version of Cascadia that has embedded Powerline symbols

The download zip contains various file formats:

  • ttf variable: we recommend this version for all users, particularly those on Windows or any other OS that employs TrueType hinting. It offers the greatest diversity of weight options (anything from 200-700).
  • ttf static: in the rare situation where the above variable font version is not supported, or a singular weight is preferred to the entire range, static formats are supplied. However, please note they do not have the same degree of hinting quality as the variable font versions.
  • otf static: for users who prefer OTF format fonts, otf static instances are provided. At this time we do not have a variable font OTF version.
  • WOFF2: These versions are provided for the purposes of web use, and are available both as variable fonts, and static instances.

Whichever format you prefer to install, we do not recommend installing more than one as it can cause naming issues within the OS.

Once unzipped, open the font file—this will open a new window displaying the characters included in the font along with the font displayed at different sizes. This window should have an "Install" button that will install the font on your machine when clicked.

👉 Note: If you have previously installed a version of Cascadia Code, please uninstall the previous version prior to installing a new version. Not doing so can result in improper rendering. Please see the double install page if you should run into issues

Installing Cascadia Code in VS Code

  1. Go to File > Preferences > Settings or hit Ctrl + , in VS Code.
  2. Enter "Font Face" in search field.
  3. Enter following in Font Face option: 'Cascadia Code', Consolas, 'Courier New', monospace.
  4. Enable Font Ligatures option available just below 'Font Face'.
  5. Press Enter and you're good to go.
  6. To customize weight, enter "Font Weight" in search field.
  7. Select, or type in, the desired font weight (the latest version of VS Code allows manual entry of any font weight).

Note: If you've installed font and it does not get applied in VS Code, try restarting VS Code.

VS Code Settings

Setting Cascadia Code in Visual Studio 2019

  1. Go to Tools > Options in Visual Studio 2019.
  2. Enter "Fonts and Colors" in search field or go to Environment > Fonts and Colors.
  3. Select Text Editor in Show settings for:.
  4. In the Fonts Dropdown select Cascadia Code.
  5. Press Ok and you're good to go.

Note: If you've installed the font and it does not get applied in Visual Studio 2019, try restarting Visual Studio 2019.

Visual Studio 2019 Settings

Setting Cascadia Code in Windows Terminal (Preview)

  1. Go to the Dropdown Preferences or hit Ctrl + , in Windows Terminal (Preview).
  2. Open the profiles.json in an editor like VS Code.
  3. Scroll down to the "profiles" Property.
  4. Look for your desired profile.
  5. Change the "fontFace" attribute to "fontFace": "Cascadia Code".

Windows Terminal (Preview) Settings

Windows Terminal (Preview) Settings

Setting Cascadia Code in IntelliJ IDE 2019

  1. Go to the Dropdown File > Settings or hit Ctrl + Alt + S in IntelliJ IDE 2019.
  2. Enter "Appearance" in search field or go to Editor > Font.
  3. Select Cascadia Code in the Dropdown.
  4. Select Enable Font Ligatures
  5. Press Ok and you're good to go.

IntelliJ IDE 2019 Settings

Installation Via Chocolatey (unofficial, by zunderscore)

Chocolatey users can download and install the latest release of Cascadia Code or any of its variants via the following packages:

choco install cascadiacode
choco install cascadiamono
choco install cascadiacodepl
choco install cascadiamonopl

You can also upgrade to the latest version by running:

choco upgrade cascadiacode
choco upgrade cascadiamono
choco upgrade cascadiacodepl
choco upgrade cascadiamonopl

Or install all at once: choco install cascadiafonts

If you have any issues installing/upgrading a package please go to that package's page (e.g. Cascadia Code) and follow the Chocolatey triage process.

Installation Via Scoop (unofficial, by sbatten)

Add the bucket

scoop bucket add nerd-fonts

Install the fonts

scoop install Cascadia-Code
scoop install Cascadia-Mono
scoop install Cascadia-PL
scoop install Cascadia-MonoPL

Update the fonts

scoop update Cascadia-Code
scoop update Cascadia-Mono
scoop update Cascadia-PL
scoop update Cascadia-MonoPL

A note on PowerLine

If you set Cascadia Code PL to be your font for PowerLine, be sure to also set:

Set-PowerLinePrompt -PowerLineFont

This will tell PowerLine that you are using a compatible font (as in, it contains the required characters). By default, the code assumes fonts don't include the codepoints and instead uses the "Left Half Block" character.

Clone this wiki locally