diff --git a/README.rst b/README.rst
index 9acf16f..453efa2 100644
--- a/README.rst
+++ b/README.rst
@@ -1520,3 +1520,15 @@
          all: True
          verbose: True
          all_cells: True
+
+
+Configure filter schedulers
+---------------------------
+At this moment only max_instances_per_host for NumInstancesFilter is supported.
+
+.. code-block:: yaml
+
+    nova:
+      controller:
+        filter_scheduler:
+          max_instances_per_host: 50