// troubleshooting guide · neovim

Neovim: module 'nvim-treesitter.configs' not found

Status
Workaround available
platforms:
Windows, macOS, Linux
updated:
November 21, 2026
reports:
2
Method
how we research
Share

RUNBOOK · neovim/module-nvim-treesitter-configs-not-found2 FIXES

// quick answer

The nvim-treesitter default branch is now a full incompatible rewrite (main) that removed nvim-treesitter.configs. Either pin the frozen master branch (Neovim 0.11) or migrate to require('nvim-treesitter').install and vim.treesitter.start().

Most likely fix: Migrate to the main-branch API

How to fix it

// try these in order, the most common fix is first

  1. FIX 1Migrate to the main-branch API

    1. 01Replace require('nvim-treesitter.configs').setup{...} with require('nvim-treesitter').install({ 'lua', 'python', 'rust' })
    2. 02Enable highlighting per filetype with an autocommand calling vim.treesitter.start()
    3. 03Install tree-sitter-cli (0.26.1+) with your package manager, not npm
    4. 04Run :checkhealth nvim-treesitter
    Did this fix it?
  2. FIX 2Stay on the frozen master branch

    1. 01Pin branch = 'master' in your plugin spec (lazy.nvim: { 'nvim-treesitter/nvim-treesitter', branch = 'master' })
    2. 02Delete the plugin directory under stdpath('data') and restart so it re-clones the right branch
    3. 03Note master is locked and only meant for Neovim 0.11
    Did this fix it?

SANDBOX · neovim RUNS IN YOUR BROWSER

Try it: edit code in a Neovim-style modal editor

A hands-on Neovim-style sandbox, including the spots where users get stuck. See where problems like this one start. 1-2 minutes, nothing is saved.

Symptoms

Error: module 'nvim-treesitter.configs' not found on startup, or highlighting disappears after :Lazy update.

Why it happens

  • C-01Plugin updated to the rewritten main branch, which has no configs module
  • C-02Old config still calls require('nvim-treesitter.configs').setup{}
  • C-03Plugin manager kept the old master checkout or mixed branches

// this guide also covers

  • module nvim-treesitter.configs not found
  • nvim-treesitter main branch
  • nvim-treesitter master vs main

Still not working?

If Neovim keeps failing, you're not alone. See every Neovim 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

Watch Neovim Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

The same problem in other apps

All not loading, error messages & connection guides →

Other Neovim errors

All 16 Neovim errors and fixes →