diff --git a/core/includes/entity.inc b/core/includes/entity.inc
index a686ec6..d6177f9 100644
--- a/core/includes/entity.inc
+++ b/core/includes/entity.inc
@@ -265,6 +265,9 @@ function entity_load_multiple($entity_type, array $ids = NULL, $reset = FALSE) {
 /**
  * Load entities by their property values.
  *
+ * @deprecated as of Drupal 8.0. Use entity_query() or the entity.query service
+ *   instead.
+ *
  * @param string $entity_type
  *   The entity type to load, e.g. node or user.
  * @param array $values