diff --git a/src/ol/layer/heatmaplayer.js b/src/ol/layer/heatmaplayer.js
index 9b17e0f263..3658144b7a 100644
--- a/src/ol/layer/heatmaplayer.js
+++ b/src/ol/layer/heatmaplayer.js
@@ -23,6 +23,9 @@ ol.layer.HeatmapLayerProperty = {
 /**
  * @classdesc
  * Layer for rendering vector data as a heatmap.
+ * Note that any property set in the options is set as a {@link ol.Object}
+ * property on the layer object; for example, setting `title: 'My Title'` in the
+ * options means that `title` is observable, and has get/set accessors.
  *
  * @constructor
  * @extends {ol.layer.Vector}
diff --git a/src/ol/layer/imagelayer.js b/src/ol/layer/imagelayer.js
index 1a99845ea9..3f9ebc536b 100644
--- a/src/ol/layer/imagelayer.js
+++ b/src/ol/layer/imagelayer.js
@@ -8,6 +8,9 @@ goog.require('ol.layer.Layer');
  * @classdesc
  * Server-rendered images that are available for arbitrary extents and
  * resolutions.
+ * Note that any property set in the options is set as a {@link ol.Object}
+ * property on the layer object; for example, setting `title: 'My Title'` in the
+ * options means that `title` is observable, and has get/set accessors.
  *
  * @constructor
  * @extends {ol.layer.Layer}
diff --git a/src/ol/layer/layerbase.js b/src/ol/layer/layerbase.js
index 28eec16d3d..6190b070fe 100644
--- a/src/ol/layer/layerbase.js
+++ b/src/ol/layer/layerbase.js
@@ -44,6 +44,9 @@ ol.layer.LayerState;
  * @classdesc
  * Abstract base class; normally only used for creating subclasses and not
  * instantiated in apps.
+ * Note that with `ol.layer.Base` and all its subclasses, any property set in
+ * the options is set as a {@link ol.Object} property on the layer object, so
+ * is observable, and has get/set accessors.
  *
  * @constructor
  * @extends {ol.Object}
diff --git a/src/ol/layer/tilelayer.js b/src/ol/layer/tilelayer.js
index 98ef732858..6a24ad8261 100644
--- a/src/ol/layer/tilelayer.js
+++ b/src/ol/layer/tilelayer.js
@@ -17,6 +17,9 @@ ol.layer.TileProperty = {
  * @classdesc
  * For layer sources that provide pre-rendered, tiled images in grids that are
  * organized by zoom levels for specific resolutions.
+ * Note that any property set in the options is set as a {@link ol.Object}
+ * property on the layer object; for example, setting `title: 'My Title'` in the
+ * options means that `title` is observable, and has get/set accessors.
  *
  * @constructor
  * @extends {ol.layer.Layer}
diff --git a/src/ol/layer/vectorlayer.js b/src/ol/layer/vectorlayer.js
index f413de79de..cef835be51 100644
--- a/src/ol/layer/vectorlayer.js
+++ b/src/ol/layer/vectorlayer.js
@@ -17,6 +17,9 @@ ol.layer.VectorProperty = {
 /**
  * @classdesc
  * Vector data that is rendered client-side.
+ * Note that any property set in the options is set as a {@link ol.Object}
+ * property on the layer object; for example, setting `title: 'My Title'` in the
+ * options means that `title` is observable, and has get/set accessors.
  *
  * @constructor
  * @extends {ol.layer.Layer}