diff --git a/README.md b/README.md
index 34fad239..6b0d2953 100644
--- a/README.md
+++ b/README.md
@@ -340,6 +340,15 @@ assertThat(pathList).containsExactly(
     "$['store']['book'][3]['author']");
 ```
 
+Set a value 
+-----------
+The library offers the possibility to set a value.
+
+```java
+String newJson = JsonPath.parse(json).set("$['store']['book'][0]['author']", "Paul").jsonString();
+```
+
+
 
 Tweaking Configuration
 ----------------------
@@ -469,4 +478,3 @@ CacheProvider.setCache(new Cache() {
 
 
 [![Analytics](https://ga-beacon.appspot.com/UA-54945131-1/jsonpath/index)](https://github.com/igrigorik/ga-beacon)
-