diff --git a/docs/source/development/concepts_in_orchest.md b/docs/source/development/concepts_in_orchest.md
index bd4cf8d596..cd00eb9233 100644
--- a/docs/source/development/concepts_in_orchest.md
+++ b/docs/source/development/concepts_in_orchest.md
@@ -27,7 +27,7 @@ Projects
     Projects. You can think of a Project as a folder on your filesystem that contains a bunch of
     Files, some of which are "special" (hinting at Pipeline files with a `.orchest` extension). In
     addition to the filesystem state, Orchest saves state in a database. This state includes things
-    such as {ref}`environment variables <environment variables>`.
+    such as {ref}`environment variables <environment-variables>`.
 
     ```{image} ../img/concepts/Project.png
     :width: 200
diff --git a/docs/source/fundamentals/jobs.md b/docs/source/fundamentals/jobs.md
index 1dae3be96a..195d08566b 100644
--- a/docs/source/fundamentals/jobs.md
+++ b/docs/source/fundamentals/jobs.md
@@ -84,7 +84,7 @@ You can think of job parameters as a [grid search](https://scikit-learn.org/stab
 i.e. looping over all combinations of values for different parameters.
 
 ```{note}
-💡 Unlike {ref}`environment variables <environment variables>`, you can define
+💡 Unlike {ref}`environment variables <environment-variables>`, you can define
 pipeline and step level parameters with the same name without one (automatically) overwriting
 the other, you can access both values.
 ```
diff --git a/docs/source/fundamentals/pipelines.md b/docs/source/fundamentals/pipelines.md
index d6f73c0f52..ac2278a52d 100644
--- a/docs/source/fundamentals/pipelines.md
+++ b/docs/source/fundamentals/pipelines.md
@@ -52,7 +52,7 @@ Pipelines take parameters as input (e.g. the data source connection URL) to vary
 pipeline. Parameters can be set in the visual pipeline editor.
 
 ```{tip}
-👉 For secrets, use {ref}`environment variables <environment variables>` since parameters are versioned.
+👉 For secrets, use {ref}`environment variables <environment-variables>` since parameters are versioned.
 ```
 
 ## Data passing
diff --git a/docs/source/fundamentals/projects.md b/docs/source/fundamentals/projects.md
index d4d464add0..698d9d759e 100644
--- a/docs/source/fundamentals/projects.md
+++ b/docs/source/fundamentals/projects.md
@@ -45,7 +45,7 @@ A project's `.orchest` directory should be versioned since it defines the {ref}`
 
 The `/data` directory can be used to store data locally that is accessible by all pipelines across all projects, even by jobs.
 
-Secrets should be set with {ref}`environment variables <environment variables>` to avoid them being versioned.
+Secrets should be set with {ref}`environment variables <environment-variables>` to avoid them being versioned.
 
 (git-inside-orchest)=