diff --git a/docs/ref/contrib/admin/index.txt b/docs/ref/contrib/admin/index.txt index 34a2348723..2815b5ddf2 100644 --- a/docs/ref/contrib/admin/index.txt +++ b/docs/ref/contrib/admin/index.txt @@ -263,15 +263,20 @@ subclass:: .. attribute:: ModelAdmin.filter_horizontal - Use a nifty unobtrusive JavaScript "filter" interface instead of the - usability-challenged ````. However, multiple-select boxes + can be difficult to use when selecting many items. Adding a + :class:`~django.db.models.ManyToManyField` to this list will instead use + a nifty unobtrusive JavaScript "filter" interface that allows searching + within the options. The unselected and selected options appear in two boxes + side by side. See :attr:`~ModelAdmin.filter_vertical` to use a vertical + interface. .. attribute:: ModelAdmin.filter_vertical - Same as ``filter_horizontal``, but is a vertical display of the filter - interface. + Same as :attr:`~ModelAdmin.filter_horizontal`, but uses a vertical display + of the filter interface with the box of unselected options appearing above + the box of selected options. .. attribute:: ModelAdmin.form