diff --git a/docs/user-guides/workspace-access/jetbrains/gateway.md b/docs/user-guides/workspace-access/jetbrains/gateway.md
index b7065b56a0..930e97c083 100644
--- a/docs/user-guides/workspace-access/jetbrains/gateway.md
+++ b/docs/user-guides/workspace-access/jetbrains/gateway.md
@@ -1,5 +1,8 @@
 ## JetBrains Gateway
 
+> [! WARNING]
+> Using Coder through JetBrains Gateway is not recommended at this time. Instead, we suggest using [JetBrains Toolbox](https://coder.com/docs/user-guides/workspace-access/jetbrains/toolbox) for stability and performance benefits. If you are currently using Gateway, we recommend [migration](https://www.jetbrains.com/help/toolbox-app/jetbrains-gateway-migrations-guide.html).
+
 JetBrains Gateway is a compact desktop app that allows you to work remotely with
 a JetBrains IDE without downloading one. Visit the
 [JetBrains Gateway website](https://www.jetbrains.com/remote-development/gateway/)