diff --git a/docs/ref/django-admin.txt b/docs/ref/django-admin.txt
index f602e327cf..ed245c5b31 100644
--- a/docs/ref/django-admin.txt
+++ b/docs/ref/django-admin.txt
@@ -222,6 +222,12 @@ program manually.
 
 Specifies the database onto which to open a shell. Defaults to ``default``.
 
+.. note::
+
+    Be aware that not all options set it in the :setting:`OPTIONS` part of your
+    database configuration in :setting:`DATABASES` are passed to the
+    command-line client, e.g. ``'isolation_level'``.
+
 ``diffsettings``
 ----------------