diff --git a/doc/api/cli.md b/doc/api/cli.md
index 2e3ef59d3d2002..1f1da714a9b03c 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 bea63a9d20c5aa..cabd33e1065e5d 100644
--- a/doc/api/esm.md
+++ b/doc/api/esm.md
@@ -674,6 +674,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.