diff --git a/core/modules/editor/src/Entity/Editor.php b/core/modules/editor/src/Entity/Editor.php
index dd102d9179750dbfdd96ab574f9a7eeb86c602c1..b8c041df85b8aac95ac6abd392900d932f33ee03 100644
--- a/core/modules/editor/src/Entity/Editor.php
+++ b/core/modules/editor/src/Entity/Editor.php
@@ -9,6 +9,11 @@
 /**
  * Defines the configured text editor entity.
  *
+ * An Editor entity is created when a filter format entity (Text format) is
+ * saved after selecting an editor plugin (eg: CKEditor). The ID of the
+ * Editor entity will be same as the ID of the filter format entity in which
+ * the editor plugin was selected.
+ *
  * @ConfigEntityType(
  *   id = "editor",
  *   label = @Translation("Text editor"),