diff --git a/docs/words.md b/docs/words.md
index 00fb1c17..5be23e68 100644
--- a/docs/words.md
+++ b/docs/words.md
@@ -33,6 +33,9 @@ Auto-show LSP references and quickly navigate between them
   foldopen = true, -- open folds after jumping
   jumplist = true, -- set jump point before jumping
   modes = { "n", "i", "c" }, -- modes to show references
+  filter = function(buf) -- what buffers to enable `snacks.words`
+    return vim.g.snacks_words ~= false and vim.b[buf].snacks_words ~= false
+  end,
 }
 ```