diff --git a/developer-docs/latest/plugins/upload.md b/developer-docs/latest/plugins/upload.md
index 424d7ab94c..3d2cf6a2b0 100644
--- a/developer-docs/latest/plugins/upload.md
+++ b/developer-docs/latest/plugins/upload.md
@@ -26,6 +26,33 @@ module.exports = {
 };
 ```
 
+#### Responsive Images
+
+When the `Enable responsive friendly upload` setting is enabled in the settings panel the plugin will generate the following responsive image sizes:
+| Name    | Largest Dimension |
+| :------ | :--------- |
+| large   | 1000px     |
+| medium  | 750px      |
+| small   | 500px      |
+
+These sizes can be overridden in `config/plugins.js`:
+```javascript
+module.exports = {
+  upload: {
+    breakpoints: {
+      xlarge: 1920,
+      large: 1000,
+      medium: 750,
+      small: 500,
+      xsmall: 64
+    }
+  }
+}
+```
+::: warning
+  Breakpoint changes will only apply to new images, existing images will not be resized or have new sizes generated.
+:::
+
 ## Endpoints
 
 <style lang="stylus">