diff --git a/packages/vscode-pyright/README.md b/packages/vscode-pyright/README.md
index 7be170b1a97c..c985fde69c79 100644
--- a/packages/vscode-pyright/README.md
+++ b/packages/vscode-pyright/README.md
@@ -4,6 +4,7 @@ Pyright is a full-featured, standards-based static type checker for Python. It i
 
 Pyright includes both a [command-line tool](/docs/command-line.md) and an [extension for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=ms-pyright.pyright).
 
+For most VS Code users, we recommend using the Pylance extension rather than Pyright. Pylance incorporates the Pyright type checker but features additional capabilities such as semantic token highlighting and symbol indexing. When Pylance is installed, the Pyright extension will disable itself.
 
 ## Documentation