Change record status: 
Project: 
Introduced in branch: 
11.2.x
Introduced in version: 
11.2.0
Description: 

Previously, $entity->original was used to access the original entity during update operations.

Instead, use \Drupal\Core\Entity\EntityInterface::getOriginal(). EntityInterface::setOriginal() can be used to manually set the original entity, for example during bulk operations to speed up performance.

Note the slight behavior change when saving non-default revisions. Previously, the original property was always the unchanged default revision, now it is the revision that had been loaded, so when saving a new non-default revision based on a previous non-default revision or updating it, changes can be correctly detected.

Implementations of EntityInterface that do not extend from EntityBase will need to add the two new methods.

Impacts: 
Module developers