diff --git a/config.yml.sample b/config.yml.sample
index fe136d89cb4..a5c99f0182a 100644
--- a/config.yml.sample
+++ b/config.yml.sample
@@ -74,6 +74,8 @@ redis:
 
 cors:
   # Whether to enable or disable cors headers.
+  # Note: If you want to put the frontend and the api on seperate domains or ports, you will need to enable this.
+  #       Otherwise the frontend won't be able to make requests to the api through the browser.
   enable: true
   # A list of origins which may access the api.
   origins:
diff --git a/docs/content/doc/setup/config.md b/docs/content/doc/setup/config.md
index d84b6effbae..105b6ec22ff 100644
--- a/docs/content/doc/setup/config.md
+++ b/docs/content/doc/setup/config.md
@@ -117,6 +117,8 @@ redis:
 
 cors:
   # Whether to enable or disable cors headers.
+  # Note: If you want to put the frontend and the api on seperate domains or ports, you will need to enable this.
+  #       Otherwise the frontend won't be able to make requests to the api through the browser.
   enable: true
   # A list of origins which may access the api.
   origins: