diff --git a/docs/rolereference.rst b/docs/rolereference.rst
index 1a38dd13e0fae9b52c29f4dc744bd1f4f18f206b..04b277d967a834a4c0b4f966840dbbebcb86829c 100644
--- a/docs/rolereference.rst
+++ b/docs/rolereference.rst
@@ -900,8 +900,17 @@ Prosody is configured as follows:
   service is set-up, with FQDN set to ``conference.DOMAIN``.
 * For each domain specified, a dedicated file proxy service will be set-up, with
   FQDN set to ``proxy.DOMAIN``.
-* For each domain specified, a dedicated http file share service will be set-up,
-  with FQDN set to ``upload.DOMAIN``.
+* For each domain specified, a dedicated http file share service is
+  set-up, with FQDN set to ``upload.DOMAIN``. Service is configured
+  with maximum upload file size limit, as well as per-user daily
+  quota. This allows clients to use `XEP-0363: HTTP File Upload
+  <https://xmpp.org/extensions/xep-0363.html>`_ for exchanging files.
+
+  .. warning::
+     Due to `bug related to global quotas
+     <https://issues.prosody.im/1891>`_, the role currently does not
+     configure global quotas in any way. This might change in the
+     future.
 
 Prosody expects a specific directory structure in LDAP when doing look-ups:
 
@@ -968,6 +977,15 @@ Parameters
   Fully qualified domain name, hostname, or IP address of the LDAP server used
   for user authentication and listing.
 
+**xmpp_http_file_share_daily_quota** (integer, optional, ``104857600``)
+  Daily quota for individual users - maximum file size in bytes that a
+  particular user can upload per day (`XEP-0363: HTTP File Upload
+  <https://xmpp.org/extensions/xep-0363.html>`_).
+
+**xmpp_http_file_share_size_limit** (integer, optional, ``10485760``)
+  Maximum file size in bytes to allow for upload (`XEP-0363: HTTP File
+  Upload <https://xmpp.org/extensions/xep-0363.html>`_).
+
 **xmpp_server_archive_expiration** (string, optional, ``never``)
   Expiration period for messages stored server-side using `XEP-0313:
   Message Archive Management