diff --git a/doc/api/errors.md b/doc/api/errors.md
index 3079e2031d7a9f..c3db6b59e3cca7 100644
--- a/doc/api/errors.md
+++ b/doc/api/errors.md
@@ -1597,12 +1597,20 @@ strict compliance with the API specification (which in some cases may accept
For APIs that accept options objects, some options might be mandatory. This code
is thrown if a required option is missing.
-
-### `ERR_MISSING_MESSAGE_PORT_IN_TRANSFER_LIST`
+
+### `ERR_MISSING_TRANSFERABLE_IN_TRANSFER_LIST`
+
An object that needs to be explicitly listed in the `transferList` argument
-was found in the object passed to a `postMessage()` call, but not provided in
-the `transferList` for that call. Usually, this is a `MessagePort`.
+was found in the object passed to a [`postMessage()`][] call, but not provided
+in the `transferList` for that call. Usually, this is a `MessagePort`.
+
+In Node.js versions prior to REPLACEME, the error code being used here was
+[`ERR_MISSING_MESSAGE_PORT_IN_TRANSFER_LIST`][]. However, the set of
+transferable object types has been expanded to cover more types than
+`MessagePort`.
### `ERR_MISSING_PASSPHRASE`
@@ -2323,6 +2331,16 @@ Used when an invalid character is found in an HTTP response status message
-->
A given index was out of the accepted range (e.g. negative offsets).
+
+### `ERR_MISSING_MESSAGE_PORT_IN_TRANSFER_LIST`
+
+
+This error code was replaced by [`ERR_MISSING_TRANSFERABLE_IN_TRANSFER_LIST`][]
+in Node.js REPLACEME, because it is no longer accurate as other types of
+transferable objects also exist now.
+
### `ERR_NAPI_CONS_PROTOTYPE_OBJECT`