diff --git a/core/modules/migrate/src/Plugin/MigrateDestinationInterface.php b/core/modules/migrate/src/Plugin/MigrateDestinationInterface.php
index 789c280e51a9b25316576bb07ce7bfba22d9ef76..d2c7fb7ee9947571214d39999fe0e1a60dff5ec7 100644
--- a/core/modules/migrate/src/Plugin/MigrateDestinationInterface.php
+++ b/core/modules/migrate/src/Plugin/MigrateDestinationInterface.php
@@ -105,6 +105,14 @@ public function fields();
    *   plugin's getIds() method if the plugin wants to save the IDs to the ID
    *   map, TRUE to indicate success without saving IDs to the ID map, or
    *   FALSE to indicate a failure.
+   *
+   * @throws \Drupal\migrate\MigrateException
+   *   Throws an exception if there is a problem importing the row. By default,
+   *   this causes the migration system to treat this row as having failed;
+   *   however, any \Drupal\migrate\Plugin\MigrateIdMapInterface status constant
+   *   can be set using the $status parameter of
+   *   \Drupal\migrate\MigrateException, such as
+   *   \Drupal\migrate\Plugin\MigrateIdMapInterface::STATUS_IGNORED.
    */
   public function import(Row $row, array $old_destination_id_values = []);