diff --git a/docs/quick-start.md b/docs/quick-start.md
index 8bcd6dcb322d..d3e1ac6cb1ed 100755
--- a/docs/quick-start.md
+++ b/docs/quick-start.md
@@ -110,7 +110,7 @@ This configuration adds a new setting, `public_folder`. While `media_folder` spe
 
 >If `public_folder` is not set, Netlify CMS will default to the same value as `media_folder`, adding an opening `/` if one is not included.
 
-The same settings can be applied on [Image/File widget](../widgets#imagefile-widget) if you store your file in different folders.
+The `media_folder` and `public_folder` settings can also be applied for individual [Image and File widgets](widgets#imagefile-widget).
 
 ### Collections
 Collections define the structure for the different content types on your static site. Since every site is different, the `collections` settings will be very different from one site to the next. Let's say your site has a blog, with the posts stored in `_posts/blog`, and files saved in a date-title format, like `1999-12-31-lets-party.md`. Each post
diff --git a/docs/widgets.md b/docs/widgets.md
index b2eb2fc39d22..7db095ae5a36 100644
--- a/docs/widgets.md
+++ b/docs/widgets.md
@@ -64,11 +64,12 @@ collections:
 
 ### Image/File Widget
 
-If you store your files in different folders e.g. cover images for your posts in **assets/postcovers** folder you can add __media_folder__ and __public_folder__ to your widged conf allowing the media go into appropriate folder.
-It would then look like this:
+If you store your images and files in different folders, you can add `media_folder` and `public_folder` properties to the widget configuration:
 
-```
-...
-  - {label: "Cover Image", name: "image", widget: "image", media_folder: "assets/postcovers", public_folder: "/assets/postcovers"}
-...
+```yaml
+  - label: Image
+    name: image
+    widget: image
+    media_folder: repo/path/to/assets
+    public_folder: /public/path/to/assets
 ```