summaryrefslogtreecommitdiff
path: root/docs/ref
diff options
context:
space:
mode:
Diffstat (limited to 'docs/ref')
-rw-r--r--docs/ref/models/fields.txt7
1 files changed, 7 insertions, 0 deletions
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 <Options.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``
-----------------