diff --git a/docs/poetry.lock b/docs/poetry.lock
index 09b9458b0..c140428f8 100644
--- a/docs/poetry.lock
+++ b/docs/poetry.lock
@@ -1,4 +1,4 @@
-# This file is automatically @generated by Poetry 1.8.3 and should not be changed by hand.
+# This file is automatically @generated by Poetry 1.8.5 and should not be changed by hand.
 
 [[package]]
 name = "alabaster"
@@ -856,13 +856,13 @@ sphinx-markdown-tables = "0.0.17"
 
 [[package]]
 name = "sphinx-scylladb-theme"
-version = "1.8.3"
+version = "1.8.4"
 description = "A Sphinx Theme for ScyllaDB documentation projects"
 optional = false
 python-versions = "<4.0,>=3.10"
 files = [
-    {file = "sphinx_scylladb_theme-1.8.3-py3-none-any.whl", hash = "sha256:4671a4488c622136228ef42f7348d8dc6f364f2e999594a24d65cab2ba96d8ac"},
-    {file = "sphinx_scylladb_theme-1.8.3.tar.gz", hash = "sha256:606478089653f6e21c245c609f40a5ba3bc478f2a867b078c476e1ac062378d3"},
+    {file = "sphinx_scylladb_theme-1.8.4-py3-none-any.whl", hash = "sha256:a3463ca22bce1cc55b2b88538dc62fae7421d15d99e67784707737fe8efdd371"},
+    {file = "sphinx_scylladb_theme-1.8.4.tar.gz", hash = "sha256:9625e4f6749788034cca76b411a5a7d4e00b914ef542db277619ea109892d93a"},
 ]
 
 [package.dependencies]
@@ -872,8 +872,9 @@ setuptools = ">=70.1.1,<76.0.0"
 sphinx-collapse = ">=0.1.1,<0.2.0"
 sphinx-copybutton = ">=0.5.2,<0.6.0"
 sphinx-notfound-page = ">=1.0.4,<2.0.0"
-Sphinx-Substitution-Extensions = ">=2022.2.16,<2023.0.0"
+Sphinx-Substitution-Extensions = ">=2022.2.16,<2026.0.0"
 sphinx-tabs = ">=3.4.5,<4.0.0"
+sphinxcontrib-mermaid = ">=1.0.0,<2.0.0"
 
 [[package]]
 name = "sphinx-sitemap"
@@ -993,6 +994,24 @@ files = [
 [package.extras]
 test = ["flake8", "mypy", "pytest"]
 
+[[package]]
+name = "sphinxcontrib-mermaid"
+version = "1.0.0"
+description = "Mermaid diagrams in yours Sphinx powered docs"
+optional = false
+python-versions = ">=3.8"
+files = [
+    {file = "sphinxcontrib_mermaid-1.0.0-py3-none-any.whl", hash = "sha256:60b72710ea02087f212028feb09711225fbc2e343a10d34822fe787510e1caa3"},
+    {file = "sphinxcontrib_mermaid-1.0.0.tar.gz", hash = "sha256:2e8ab67d3e1e2816663f9347d026a8dee4a858acdd4ad32dd1c808893db88146"},
+]
+
+[package.dependencies]
+pyyaml = "*"
+sphinx = "*"
+
+[package.extras]
+test = ["defusedxml", "myst-parser", "pytest", "ruff", "sphinx"]
+
 [[package]]
 name = "sphinxcontrib-qthelp"
 version = "2.0.0"
@@ -1310,4 +1329,4 @@ files = [
 [metadata]
 lock-version = "2.0"
 python-versions = "^3.10"
-content-hash = "53f6557d6f9f9d208459008ff8d83b4940407671d90bec20ff57231e481e8170"
+content-hash = "54c833fb40b8c83d56cf150ea3be1d62522fa7fcbd27ecfe0714005116ec234f"
diff --git a/docs/pyproject.toml b/docs/pyproject.toml
index 8548982e0..e3c23812a 100644
--- a/docs/pyproject.toml
+++ b/docs/pyproject.toml
@@ -9,7 +9,7 @@ package-mode = false
 python = "^3.10"
 pygments = "^2.18.0"
 redirects_cli = "^0.1.3"
-sphinx-scylladb-theme = "^1.8.1"
+sphinx-scylladb-theme = "^1.8.4"
 sphinx-sitemap = "^2.6.0"
 sphinx-autobuild = "^2024.4.19"
 Sphinx = "^7.3.7"