diff --git a/pyproject.toml b/pyproject.toml
index db3414575..64d433ff4 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -90,6 +90,7 @@ client = ["optimade[cif]"]
 docs = [
     "mike~=2.0",
     "mkdocs~=1.4",
+    "mkdocs-autoref~=1.0,<1.1",
     "mkdocs-awesome-pages-plugin~=2.8",
     "mkdocs-material~=9.0",
     "mkdocstrings[python]~=0.20",
diff --git a/requirements-docs.txt b/requirements-docs.txt
index 0f296329e..f014ee571 100644
--- a/requirements-docs.txt
+++ b/requirements-docs.txt
@@ -1,5 +1,6 @@
 mike==2.1.3
 mkdocs==1.6.0
+mkdocs-autoref==1.0.1
 mkdocs-awesome-pages-plugin==2.9.3
 mkdocs-material==9.5.33
 mkdocstrings[python]==0.25.2