diff --git a/doc/ring/swagger.md b/doc/ring/swagger.md
index cf45e231..ade798ff 100644
--- a/doc/ring/swagger.md
+++ b/doc/ring/swagger.md
@@ -65,6 +65,10 @@ Webjars also hosts a [version](https://github.com/webjars/swagger-ui) of the swa
 
 **NOTE:** If you want to use swagger-ui 2.x you can do so by explicitly downgrading `metosin/ring-swagger-ui` to `2.2.10`.
 
+**NOTE:** If you use swagger-ui 3.x, you need to include `:responses` for Swagger-UI
+to display the response when trying out endpoints. You can define `:responses {200 {:schema s/Any}}`
+at the top-level to show responses for all endpoints.
+
 ## Examples
 
 ### Simple example