diff --git a/doc/api/cli.md b/doc/api/cli.md
index 2681d051718f99..e9e4742b210a94 100644
--- a/doc/api/cli.md
+++ b/doc/api/cli.md
@@ -301,7 +301,12 @@ Enable experimental `import.meta.resolve()` support.
 ### `--experimental-loader=module`
 
 <!-- YAML
-added: v9.0.0
+added: v8.8.0
+changes:
+  - version: v12.11.1
+    pr-url: https://github.com/nodejs/node/pull/29752
+    description: This flag was renamed from `--loader` to
+                 `--experimental-loader`.
 -->
 
 Specify the `module` of a custom experimental [ECMAScript module loader][].
diff --git a/doc/api/esm.md b/doc/api/esm.md
index 6e7356740dc880..8c54a6a15e8001 100644
--- a/doc/api/esm.md
+++ b/doc/api/esm.md
@@ -664,6 +664,15 @@ of Node.js applications.
 
 ## Loaders
 
+<!-- YAML
+added: v8.8.0
+changes:
+  - version: v16.12.0
+    pr-url: https://github.com/nodejs/node/pull/37468
+    description: Removed `getFormat`, `getSource`, `transformSource`, and
+                 `globalPreload`; added `load` hook and `getGlobalPreload` hook.
+-->
+
 > Stability: 1 - Experimental
 
 > This API is currently being redesigned and will still change.