[5.2.x] Fixed #36095 -- Introduced lazy references in "Models across files" section.

Backport of 6a2c296e706a0b8f9f9b89e66b37001ce2a03ea7 from main.

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
 -----------------------