diff --git a/README.md b/README.md
index db192110f62..d1051f22482 100644
--- a/README.md
+++ b/README.md
@@ -170,6 +170,12 @@ var q = ds.createQuery('Company')
     .filter('size <', 400);
 ~~~~
 
+In order to filter by ancestors, use `hasAncestor` helper.
+
+~~~ js
+var q = ds.createQuery('Child').hasAncestor(['Parent', 123]);
+~~~
+
 ##### Sorting
 
 You can sort the results by a property name ascendingly or descendingly.