Refs #30083 -- Clarified database state of instances in signals.pre_init docs.

1 files changed, 7 insertions, 0 deletions

diff --git a/docs/ref/signals.txt b/docs/ref/signals.txt
index f2f0ab4257..a89560cc1e 100644
--- a/docs/ref/signals.txt
+++ b/docs/ref/signals.txt
@@ -99,6 +99,13 @@ Arguments sent with this signal:
 ``instance``
     The actual instance of the model that's just been created.
 
+    .. note::
+
+        ``instance._state`` isn't set before sending the ``post_init`` signal,
+        so ``_state`` attributes always have their default values. For example,
+        ``_state.db`` is ``None`` and cannot be used to check an ``instance``
+        database.
+
 ``pre_save``
 ------------