diff --git a/doc/api/querystring.md b/doc/api/querystring.md
index 2b8755df413914..4b7db7afc3b948 100644
--- a/doc/api/querystring.md
+++ b/doc/api/querystring.md
@@ -2,7 +2,7 @@
 
 <!--introduced_in=v0.1.25-->
 
-> Stability: 2 - Stable
+> Stability: 3 - Legacy
 
 <!--name=querystring-->
 
@@ -15,6 +15,9 @@ query strings. It can be accessed using:
 const querystring = require('querystring');
 ```
 
+The `querystring` API is considered Legacy. While it is still maintained,
+new code should use the {URLSearchParams} API instead.
+
 ## `querystring.decode()`
 <!-- YAML
 added: v0.1.99