diff --git a/editors/vscode/README.md b/editors/vscode/README.md
index 970e20531bf65..f43dc1efd190f 100644
--- a/editors/vscode/README.md
+++ b/editors/vscode/README.md
@@ -30,7 +30,9 @@ To enable it as your default formatter, use a VS Code `settings.json` like:
 
 ```json
 {
-  "editor.defaultFormatter": "oxc.oxc-vscode"
+  "editor.defaultFormatter": "oxc.oxc-vscode",
+  "editor.formatOnSave": true,
+  "editor.formatOnSaveMode": "file" // tell oxfmt to format the whole file, not only the modified lines
   // Or enable it for specific file types:
   // "[javascript]": {
   //   "editor.defaultFormatter": "oxc.oxc-vscode"