[1.7.x] Fixed #23354 -- Documented that ModelChoiceField to_field_name should be a unique field.

Thanks Keryn Knight for the suggestion.

Backport of 83762da3fb from master

1 files changed, 4 insertions, 2 deletions

diff --git a/docs/ref/forms/fields.txt b/docs/ref/forms/fields.txt
index 1eeb65261e..0bcbe6c72c 100644
--- a/docs/ref/forms/fields.txt
+++ b/docs/ref/forms/fields.txt
@@ -1061,8 +1061,10 @@ method::
     .. attribute:: to_field_name
 
         This optional argument is used to specify the field to use as the value
-        of the choices in the field's widget. By default it is set to ``None``,
-        in which case the primary key of each object will be used. For example::
+        of the choices in the field's widget. Be sure it's a unique field for
+        the model, otherwise the selected value could match more than one
+        object. By default it is set to ``None``, in which case the primary key
+        of each object will be used. For example::
 
             # No custom to_field_name
             field1 = forms.ModelChoiceField(queryset=...)