diff --git a/mkdocs.yml b/mkdocs.yml
index 197649435..0a46f6cdb 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -102,7 +102,8 @@ plugins:
               replace_admonitions: true
             show_if_no_docstring: false
   - awesome-pages
-  - autorefs
+  - autorefs:
+      resolve_closest: true
 
 watch:
   - optimade
diff --git a/pyproject.toml b/pyproject.toml
index b639a5e71..1d511ff4f 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -90,11 +90,11 @@ client = ["optimade[cif]"]
 # General
 docs = [
     "mike~=2.0",
-    "mkdocs~=1.4",
-    "mkdocs-autorefs>=1,<2",
+    "mkdocs~=1.6",
+    "mkdocs-autorefs~=1.2",
     "mkdocs-awesome-pages-plugin~=2.8",
     "mkdocs-material~=9.0",
-    "mkdocstrings[python]~=0.20",
+    "mkdocstrings[python]~=0.26",
 ]
 
 testing = [
diff --git a/requirements-docs.txt b/requirements-docs.txt
index f2959e719..0e4dfaeec 100644
--- a/requirements-docs.txt
+++ b/requirements-docs.txt
@@ -1,6 +1,6 @@
 mike==2.1.3
 mkdocs==1.6.1
-mkdocs-autorefs==1.0.1
+mkdocs-autorefs==1.2.0
 mkdocs-awesome-pages-plugin==2.9.3
 mkdocs-material==9.5.34
-mkdocstrings[python]==0.25.2
+mkdocstrings[python]==0.26.0