diff --git a/docs/ref/models/fields.txt b/docs/ref/models/fields.txt index 81f3013892..c449a1381c 100644 --- a/docs/ref/models/fields.txt +++ b/docs/ref/models/fields.txt @@ -351,6 +351,13 @@ looking at your Django code. For example:: If ``True``, a database index will be created for this field. +.. admonition:: Use the :attr:`~Options.indexes` option instead. + + Where possible, use the :attr:`Meta.indexes ` option + instead. In nearly all cases, :attr:`~Options.indexes` provides more + functionality than ``db_index``. ``db_index`` may be deprecated in the + future. + ``db_tablespace`` -----------------