diff --git a/components/sensor/tcs34725.rst b/components/sensor/tcs34725.rst
index 42dfa4af1..4def11916 100644
--- a/components/sensor/tcs34725.rst
+++ b/components/sensor/tcs34725.rst
@@ -11,6 +11,12 @@ The ``tcs34725`` sensor platform allows you to use your TCS34725 RGB color senso
 `Adafruit`_), color temperature and illuminance sensors with ESPHome. The :ref:`I²C <i2c>` is
 required to be set up in your configuration for this sensor to work.
 
+Note: If the `integration_time` is set too long for the light conditions, the sensor will overexpose.
+In this case the sensor may not show 100% on its clear channel. With an `integration_time` of `614ms`
+and a `gain` of `1x` the sensor will max out at around 4100 lx. In this case the individual color
+channels will show `100%`, the clear channel `25%`. The illumination in lux is shown as `0` as well
+as the color temperature in kelvin will show `0`.
+
 .. figure:: images/tcs34725-full.jpg
     :align: center
     :width: 50.0%