diff --git a/docs/topics/http/urls.txt b/docs/topics/http/urls.txt
index 7a0e7243e8..8be72d243b 100644
--- a/docs/topics/http/urls.txt
+++ b/docs/topics/http/urls.txt
@@ -818,6 +818,13 @@ This ``current_app`` argument is used as a hint to resolve application
 namespaces into URLs on specific application instances, according to the
 :ref:`namespaced URL resolution strategy <topics-http-reversing-url-namespaces>`.
 
+You can use ``kwargs`` instead of ``args``, for example::
+
+    >>> reverse('admin:app_list', kwargs={'app_label': 'auth'})
+    '/admin/auth/'
+
+``args`` and ``kwargs`` cannot be passed to ``reverse()`` at the same time.
+
 .. admonition:: Make sure your views are all correct.
 
     As part of working out which URL names map to which patterns, the