How to update Vale on Windows

Use this instruction to update the Vale linter version on Windows.

Our goal is to update the Vale version on a computer running Windows.

Use Chocolatey

First, go to the official Vale installation page. As you see, the Chocolatey package manager is the recommended option for installing Vale on Windows. You can use Chocolatey to update Vale.

To update Vale using Chocolatey:

  1. Make sure you have Vale installed.

    vale -v

    This command shows the version of Vale installed.

  2. Make sure you have Chocolatey installed.

    choco -v

    This command shows the version of Chocolatey installed.

  3. Update the Vale version.

    choco upgrade vale

    This command updates Vale to the latest version of Vale stored as the Chocolatey package.


Update Vale manually

The Chocolatey package may not be the latest version of Vale available in the official Vale release page. You need to download and install the latest Vale version manually.

To update Vale manually:

  1. Go to the official Vale release page.

  2. Download the latest Vale version for your operating system.

    In my case, it’s v2.13.0 that has the Latest label. This version supports readability checks by Vale.

  3. Unzip the downloaded archive. For example,

  4. Copy and replace the vale.exe file to the Chocolatey folder where your Vale is installed. In my case, it’s C:\ProgramData\chocolatey\bin.

  5. Check the updated Vale version.

    vale -v

    You should have the latest Vale version installed.

VS Code Vale extension for readability

Currently, VS Code doesn’t support automatic readability check. See this GitHub issue. Run the manual check for readability.

To check for readability:

  1. Go to the directory with the Markdown file you want to check for readability. For example:

    cd c:\Users\ivanc\docsy-site\content\en\docs\vale\
  2. Run the Vale check. For example:


    Vale CLI shows the readability scores.

    Readability scores

For more information, see the Vale readability metrics.

Last modified April 1, 2023: edited update vale (d8bea40)