diff --git a/docs/apache-airflow/configurations-ref.rst b/docs/apache-airflow/configurations-ref.rst
index d9f76904825..63c5c96bfc1 100644
--- a/docs/apache-airflow/configurations-ref.rst
+++ b/docs/apache-airflow/configurations-ref.rst
@@ -22,6 +22,11 @@ Configuration Reference
 This page contains the list of all the available Airflow configurations that you
 can set in ``airflow.cfg`` file or using environment variables.
 
+Use the same configuration across all the Airflow components. While each component
+does not require all, some configurations need to be same otherwise they would not
+work as expected. A good example for that is :ref:`secret_key<config:webserver__secret_key>` which
+should be same on the Webserver and Worker to allow Webserver to fetch logs from Worker.
+
 .. note::
     For more information on setting the configuration, see :doc:`howto/set-config`
 
diff --git a/docs/apache-airflow/howto/set-config.rst b/docs/apache-airflow/howto/set-config.rst
index d36a96f741e..03cf0dea460 100644
--- a/docs/apache-airflow/howto/set-config.rst
+++ b/docs/apache-airflow/howto/set-config.rst
@@ -115,3 +115,9 @@ the example below.
 
 .. note::
     See :doc:`../modules_management` for details on how Python and Airflow manage modules.
+
+.. note::
+    Use the same configuration across all the Airflow components. While each component
+    does not require all, some configurations need to be same otherwise they would not
+    work as expected. A good example for that is :ref:`secret_key<config:webserver__secret_key>` which
+    should be same on the Webserver and Worker to allow Webserver to fetch logs from Worker.