diff --git a/docs/source/conf.py b/docs/source/conf.py
index 50d62af65..de25e2e87 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -225,3 +225,21 @@
                         message='Matplotlib is currently using agg, which is a'
                                 ' non-GUI backend, so cannot show the figure.')
 # endregion
+
+extensions.append("sphinx_multiversion")
+
+# Optional: Control which branches/tags are included
+# Match exactly these two tags
+smv_tag_whitelist = r'^2025\.1\.0rc0$|^2024\.2\.0\.2$'
+
+# Match only the 'main' branch
+smv_branch_whitelist = r'^main$'
+
+# Optional: only use the origin remote
+smv_remote_whitelist = r'^origin$'
+
+# Mark tagged versions as "released"
+smv_released_pattern = r'^2025\.1\.0rc0$|^2024\.2\.0\.2$'
+
+# Optional: Add version to the HTML title
+html_title = f"GemPy Documentation ({version})"
\ No newline at end of file
diff --git a/requirements/docs_requirements.txt b/requirements/docs_requirements.txt
index b8f94197c..b34175077 100644
--- a/requirements/docs_requirements.txt
+++ b/requirements/docs_requirements.txt
@@ -7,6 +7,7 @@ sphinx
 sphinx-gallery
 sphinx_design
 sphinx_automodapi
+sphinx-multiversion
 liquid-earth-sdk
 wellpathpy