diff --git a/docs/ref/django-admin.txt b/docs/ref/django-admin.txt
index f2029e9b19..81672b46f4 100644
--- a/docs/ref/django-admin.txt
+++ b/docs/ref/django-admin.txt
@@ -211,6 +211,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``
 ----------------