From 63c56cda133a85a158502891c40465bc0331d3d9 Mon Sep 17 00:00:00 2001
From: Annabelle Wiegart <annabelle.wiegart@proton.me>
Date: Sun, 18 Jan 2026 20:03:28 +0100
Subject: Fixed #35870 -- Made blank choice label in forms more accessible.

Added new constant django.db.models.fields.BLANK_CHOICE_LABEL for
an accessible and translatable blank choice label in forms.
Deprecated django.db.models.fields.BLANK_CHOICE_DASH constant.
Added the immediately deprecated transitional setting
USE_BLANK_CHOICE_DASH.

Co-Authored-By: Marijke Luttekes <mail@marijkeluttekes.dev>
---
 docs/ref/forms/fields.txt | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

(limited to 'docs/ref/forms')

diff --git a/docs/ref/forms/fields.txt b/docs/ref/forms/fields.txt
index 73faa8cc18..085b36a0e5 100644
--- a/docs/ref/forms/fields.txt
+++ b/docs/ref/forms/fields.txt
@@ -1384,7 +1384,7 @@ generating choices. See :ref:`iterating-relationship-choices` for details.
 
         By default the ``<select>`` widget used by ``ModelChoiceField`` will
         have an empty choice at the top of the list. You can change the text of
-        this label (which is ``"---------"`` by default) with the
+        this label (which is ``"- Select an option -"`` by default) with the
         ``empty_label`` attribute, or you can disable the empty label entirely
         by setting ``empty_label`` to ``None``::
 
@@ -1400,6 +1400,11 @@ generating choices. See :ref:`iterating-relationship-choices` for details.
         :class:`~django.forms.RadioSelect` and the
         :attr:`~ModelChoiceField.blank` argument is ``False``.
 
+    .. versionchanged:: 6.1
+
+        The default empty label was changed from ``"---------"`` to
+        ``"- Select an option -"``.
+
     .. attribute:: to_field_name
 
         This optional argument is used to specify the field to use as the value
-- 
cgit v1.3