diff --git a/docs/src/docs/welcome/integrations.mdx b/docs/src/docs/welcome/integrations.mdx
index 747b7ee29e2d..03e6d7e8d57e 100644
--- a/docs/src/docs/welcome/integrations.mdx
+++ b/docs/src/docs/welcome/integrations.mdx
@@ -15,6 +15,8 @@ Both v1 and v2 versions are supported.
 
 Install the [extension](https://marketplace.visualstudio.com/items?itemName=golang.Go).
 
+**Note:** To use golangci-lint v2, you may need to switch to the pre-release version of the extension: [vscode-go#3732](https://github.com/golang/vscode-go/issues/3732#issuecomment-2805974456).
+
 <details>
 <summary style={{color: '#737380'}}>Recommended settings for those who installed golangci-lint manually</summary>