Try or ByeTry or Bye

Helix Syntax Highlighting Not Working

Share
Workaround available Linux, macOS, Windows Updated November 15, 2026Based on 3 user reportsHow we research

Quick answer

Usually the runtime directory or tree-sitter grammars are missing. Run hx --health <language>, point Helix at the runtime folder and fetch and build grammars.

Most likely fix: Check health for the language

How to fix it

Try these in order — the most common fix is first.

  1. 1. Check health for the language

    1. Run hx --health <language>
    2. Confirm Highlight queries has a check mark
    Did this fix it?

  2. 2. Make the runtime folder discoverable

    1. Put runtime next to the hx binary or in ~/.config/helix/ (Linux/macOS) or ~/AppData/Roaming/helix/ (Windows)
    2. Or set the HELIX_RUNTIME environment variable
    3. Run hx --health to see searched directories
    Did this fix it?

  3. 3. Fetch and build grammars

    1. Run hx --grammar fetch (needs git)
    2. Run hx --grammar build (needs a C++ compiler)
    Did this fix it?

  4. 4. Check the log

    1. Inside Helix run :log-open
    Did this fix it?

Symptoms

Files show no colors, or hx --health shows a missing mark next to Highlight queries.

Why it happens

  • Runtime folder not in the executable directory or config directory
  • runtime/grammars is empty
  • Stale queries out of sync with parsers

This guide also covers

  • helix syntax highlighting not working
  • helix no syntax highlighting
  • helix runtime not found

Still not working?

If Helix keeps failing, you're not alone. See every Helix problem users report or the alternatives people switch to.

Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.

Talk to us
Fixed it? Share this guide

Other Helix errors