diff --git a/doc/api/process.md b/doc/api/process.md
index b1542e0be1e..9f72b88bf70 100644
--- a/doc/api/process.md
+++ b/doc/api/process.md
@@ -578,6 +578,10 @@ address such failures, a non-operational
 `resource.loaded`, which would prevent the `'unhandledRejection'` event from
 being emitted.
 
+If an `'unhandledRejection'` event is emitted but not handled it will
+be raised as an uncaught exception. This alongside other behaviors of
+`'unhandledRejection'` events can changed via the [`--unhandled-rejections`][] flag.
+
 ### Event: `'warning'`
 
 <!-- YAML