diff --git a/README.md b/README.md
index ababc67f..26479d68 100644
--- a/README.md
+++ b/README.md
@@ -351,6 +351,19 @@ Add filters to the list. Each field maps a property in the API endpoint result.
nga.field('age', 'number')
]);
+ Filters appear when the user clicks on the "Add filter" button at the top of the list. You can also set a filter field as "pinned", to be sure it's always displayed.
+
+ listView.filters([
+ nga.field('q').label('Search').pinned(true)
+ ]);
+
+ Filter fields can be of any type, including `reference` and `template`. this allows to define custom filters with ease.
+
+ listView.filters([
+ nga.field('q', 'template').label('')
+ .template('
'),
+ ]);
+
* `listActions(String|Array)`
Add an action column with action buttons on each line. You can pass a list of button names among 'show', 'edit', and 'delete'.
@@ -455,6 +468,9 @@ A list of CSS classes to be added to the corresponding field. If you provide a f
* `defaultValue(*)`
Define the default value of the field in the creation form.
+* `pinned(boolean)`
+Whether the field should always appear. Used in filters (see listView Settings). Default to false.
+
### `number` Field Settings
* `format(string)`
diff --git a/examples/blog/config.js b/examples/blog/config.js
index 981755ee..d621c3df 100644
--- a/examples/blog/config.js
+++ b/examples/blog/config.js
@@ -160,7 +160,10 @@
.targetField(nga.field('title').map(truncate))
])
.filters([
- nga.field('q', 'string').label('Search'),
+ nga.field('q', 'template')
+ .label('')
+ .pinned(true)
+ .template('