diff --git a/README.md b/README.md
index 5e1b99f7..3ba51e52 100644
--- a/README.md
+++ b/README.md
@@ -131,7 +131,7 @@
   - [`useStateList`](./docs/useStateList.md) — circularly iterates over an array. [![][img-demo]](https://codesandbox.io/s/bold-dewdney-pjzkd)
   - [`useToggle` and `useBoolean`](./docs/useToggle.md) — tracks state of a boolean. [![][img-demo]](https://codesandbox.io/s/focused-sammet-brw2d)
   - [`useCounter` and `useNumber`](./docs/useCounter.md) — tracks state of a number. [![][img-demo]](https://streamich.github.io/react-use/?path=/story/state-usecounter--demo)
-  - [`useList`](./docs/useList.md) — tracks state of an array. [![][img-demo]](https://codesandbox.io/s/wonderful-mahavira-1sm0w)
+  - [`useList`](./docs/useList.md) and [`useUpsert`](./docs/useUpsert.md) — tracks state of an array. [![][img-demo]](https://codesandbox.io/s/wonderful-mahavira-1sm0w)
   - [`useMap`](./docs/useMap.md) — tracks state of an object. [![][img-demo]](https://codesandbox.io/s/quirky-dewdney-gi161)
 
 
diff --git a/docs/useList.md b/docs/useList.md
index b2dad670..e09709c9 100644
--- a/docs/useList.md
+++ b/docs/useList.md
@@ -25,3 +25,7 @@ const Demo = () => {
   );
 };
 ```
+
+## Related hooks
+
+- [useUpsert](./useUpsert.md)
diff --git a/docs/useUpsert.md b/docs/useUpsert.md
index 2384660d..48c3de55 100644
--- a/docs/useUpsert.md
+++ b/docs/useUpsert.md
@@ -1,6 +1,7 @@
 # `useUpsert`
 
-Superset of `useList`. Provides an additional method to upsert (update or insert) an element into the list. 
+Superset of [`useList`](./useList.md). Provides an additional method to upsert (update or insert) an element into the list.
+
 ## Usage
 
 ```jsx
@@ -26,3 +27,7 @@ const Demo = () => {
   );
 };
 ```
+
+## Related hooks
+
+- [useList](./useList.md)