diff --git a/docs/ref/models/fields.txt b/docs/ref/models/fields.txt index e0cf92f9c3..c94309257c 100644 --- a/docs/ref/models/fields.txt +++ b/docs/ref/models/fields.txt @@ -572,6 +572,11 @@ information on the available attributes and methods, see the :class:`~django.core.files.File` class reference and the :doc:`/topics/files` topic guide. +.. note:: + The file is saved as part of saving the model in the database, so the actual + file name used on disk cannot be relied on until after the model has been + saved. + The uploaded file's relative URL can be obtained using the :attr:`~django.db.models.fields.FileField.url` attribute. Internally, this calls the :meth:`~django.core.files.storage.Storage.url` method of the diff --git a/docs/topics/files.txt b/docs/topics/files.txt index e9d46f116e..9ab8d5c496 100644 --- a/docs/topics/files.txt +++ b/docs/topics/files.txt @@ -45,6 +45,12 @@ the details of the attached photo:: This object -- ``car.photo`` in the example -- is a ``File`` object, which means it has all the methods and attributes described below. +.. note:: + The file is saved as part of saving the model in the database, so the actual + file name used on disk cannot be relied on until after the model has been + saved. + + The ``File`` object ===================