diff --git a/docs/clients/minidump/crashpad.rst b/docs/clients/minidump/crashpad.rst
index cb2aaace4ebe5d..4f63683bc0cecf 100644
--- a/docs/clients/minidump/crashpad.rst
+++ b/docs/clients/minidump/crashpad.rst
@@ -58,6 +58,16 @@ platforms, child processes must also register by using `SetHandlerIPCPipe()`_.
 For more information on configuring the crashpad handler, see
 `crashpad_handler`_.
 
+.. admonition:: Known Issue
+
+    Sentry cannot handle gzip compressed minidump submissions and will respond
+    with a 400 error. To fix this, pass the ``--no-upload-gzip`` argument to the
+    handler:
+
+    .. code-block:: cpp
+
+        arguments.push_back("--no-upload-gzip");
+
 If you also want Crashpad to upload crashes to Sentry, additionally configure
 the Crashpad database for automatic uploads:
 
@@ -73,6 +83,13 @@ the Crashpad database for automatic uploads:
       db->GetSettings()->SetUploadsEnabled(true);
     }
 
+By default, the crashpad handler will limit uploads to one per hour. To disable
+this limitation, pass the ``--no-rate-limit`` argument to the handler:
+
+.. code-block:: cpp
+
+    arguments.push_back("--no-rate-limit");
+
 .. _Crashpad: https://chromium.googlesource.com/crashpad/crashpad/+/master/README.md
 .. _Developing Crashpad: https://chromium.googlesource.com/crashpad/crashpad/+/HEAD/doc/developing.md
 .. _StartHandler(): https://crashpad.chromium.org/doxygen/classcrashpad_1_1CrashpadClient.html#a810ad9941bedba543bf60507c31c55da