Fixed #22473 -- Emphasized that Model.clean() is not called from Model.save().

1 files changed, 3 insertions, 0 deletions

diff --git a/docs/ref/models/instances.txt b/docs/ref/models/instances.txt
index 9bc7b841c7..1b7226b648 100644
--- a/docs/ref/models/instances.txt
+++ b/docs/ref/models/instances.txt
@@ -143,6 +143,9 @@ access to more than a single field::
             if self.status == 'published' and self.pub_date is None:
                 self.pub_date = datetime.date.today()
 
+Note, however, that like :meth:`Model.full_clean()`, a model's ``clean()``
+method is not invoked when you call your model's :meth:`~Model.save()` method.
+
 Any :exc:`~django.core.exceptions.ValidationError` exceptions raised by
 ``Model.clean()`` will be stored in a special key error dictionary key,
 :data:`~django.core.exceptions.NON_FIELD_ERRORS`, that is used for errors