diff --git a/README.md b/README.md
index dce11ff..b565f30 100644
--- a/README.md
+++ b/README.md
@@ -52,3 +52,16 @@
 // if any.
 fmt.Printf("%#v", result)
 ```
+
+If decoding fails for any reason, very helpful errors are returned. For
+example, the string format of a `mapstructure.Error` may look like this:
+
+```
+5 error(s) decoding:
+
+* 'Name' expected type 'string', got 'int'
+* 'Age' expected type 'int', got 'string'
+* 'Emails[0]' expected type 'string', got 'int'
+* 'Emails[1]' expected type 'string', got 'int'
+* 'Emails[2]' expected type 'string', got 'int'
+```