diff --git a/docs/concepts-basics/docker-compose-yml.md b/docs/concepts-basics/docker-compose-yml.md
index 15ed04a17d..1cf84cc669 100644
--- a/docs/concepts-basics/docker-compose-yml.md
+++ b/docs/concepts-basics/docker-compose-yml.md
@@ -428,3 +428,4 @@ The corrected version combines both aliases into a single mapping key - you'll n
 These settings have been deprecated and should be removed from use in your `docker-compose.yml`.
 
 * `services.[name].labels.lagoon.rollout`
+* `services.[name].labels.lagoon.template`
diff --git a/docs/concepts-basics/lagoon-yml.md b/docs/concepts-basics/lagoon-yml.md
index 7f7769921e..5d3c37126c 100644
--- a/docs/concepts-basics/lagoon-yml.md
+++ b/docs/concepts-basics/lagoon-yml.md
@@ -512,26 +512,6 @@ environments:
       mariadb: mariadb-single
 ```
 
-### `environments.[name].templates`
-
-The Lagoon build process checks the `lagoon.template` label from the `docker-compose.yml` file in order to check if the service needs a custom template file \(read more about them in the [documentation of `docker-compose.yml`](docker-compose-yml.md)\).
-
-Sometimes you might want to override the **template** just for a single environment, and not for all of them:
-
-`service-name: template-file`
-
-* `service-name` is the name of the service from `docker-compose.yml` you would like to override.
-* `template-file` is the path and name of the template to use for this service in this environment.
-
-#### Example Template Override
-
-```yaml title=".lagoon.yml"
-environments:
-  main:
-    templates:
-      mariadb: mariadb.main.deployment.yml
-```
-
 ### `environments.[name].autogenerateRoutes`
 
 This allows for any environments to get autogenerated routes when route autogeneration is disabled.
@@ -799,8 +779,6 @@ environments:
         - www.example.ch
     types:
       mariadb: mariadb
-    templates:
-      mariadb: mariadb.main.deployment.yml
     cronjobs:
       - name: drush cron
         schedule: "M * * * *" # This will run the cron once per hour.
@@ -834,3 +812,5 @@ These settings have been deprecated and should be removed from use in your `.lag
 * `environments.[name].routes.[service].[route].insecure`
 
     The `None` option is equivalent to `Redirect`.
+
+* `environments.[name].templates`