summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorClifford Gama <cliffygamy@gmail.com>2025-01-13 21:15:57 +0200
committerSarah Boyce <42296566+sarahboyce@users.noreply.github.com>2025-03-21 14:09:10 +0100
commit6a2c296e706a0b8f9f9b89e66b37001ce2a03ea7 (patch)
tree37aae348d9bc255e68f3c1d0562db9c8159586a0 /docs
parenteb4ea9c3efca479b169bed88a5521c4cf47ed2a2 (diff)
Fixed #36095 -- Introduced lazy references in "Models across files" section.
Diffstat (limited to 'docs')
-rw-r--r--docs/topics/db/models.txt18
1 files changed, 18 insertions, 0 deletions
diff --git a/docs/topics/db/models.txt b/docs/topics/db/models.txt
index b7bd36bc81..98fb149b98 100644
--- a/docs/topics/db/models.txt
+++ b/docs/topics/db/models.txt
@@ -720,6 +720,24 @@ refer to the other model class wherever needed. For example::
null=True,
)
+Alternatively, you can use a lazy reference to the related model, specified as
+a string in the format ``"app_label.ModelName"``. This does not require the
+related model to be imported. For example::
+
+ from django.db import models
+
+
+ class Restaurant(models.Model):
+ # ...
+ zip_code = models.ForeignKey(
+ "geography.ZipCode",
+ on_delete=models.SET_NULL,
+ blank=True,
+ null=True,
+ )
+
+See :ref:`lazy relationships <lazy-relationships>` for more details.
+
Field name restrictions
-----------------------