diff --git a/README.md b/README.md
index 1d4e18d..e61a464 100644
--- a/README.md
+++ b/README.md
@@ -1,46 +1,60 @@
-# Swiss Locator plugin
-
+# QGIS Swiss Locator plugin
 
 ## What 
-A Swiss Geoportal locator filter plugin for QGIS 3
+Integrates the Swiss Geoportal into QGIS
 
 Similarly to the online geoportal [https://map.geo.admin.ch](https://map.geo.admin.ch/), this plugin allows to search within [QGIS](https://qgis.org/) desktop for
 
-* locations:
-   * cantons, cities and communes,
-   * all names as printed on the national map (SwissNames)
-   * districts
+* Locations:
+   * Cantons, cities and municipalities,
+   * Place names as printed on the national map (SwissNames)
+   * Districts
    * ZIP codes
-   * addresses
-   * cadastral parcels
-* WMS layers from Federal Geoportal (map.geo.admin.ch) or opendata.swiss, which can easily be added to the map
-* features (search through features descriptions)
-
-
-## Where
-
-The search is performed through the QGIS [locator bar](https://qgis.org/en/site/forusers/visualchangelog30/#feature-locator-bar).
-
-Configuration is achieved in the main application settings under the `locator` tab. You will be able to:
-* enable or disable searches (locations, layers, features)
-* customize prefixes, define if they are default filters (used without prefix)
-* access to the configuration of the plugin
-* include or exclude opendata.swiss data from layer searches
-
-In the configuration of the plugin, further customization can be achieved:
-* language definition (English, German, French, Italian, Rumantsch)
-* CRS definition (project, CH1903 or CH1903+)
-* defining if the plugin will try to display further information in a tool tip
-* defining layers used in the feature search
+   * Addresses
+   * Cadastral parcels
+* Layers from the Federal Geoportal (map.geo.admin.ch) or opendata.swiss, which can easily be added to the map
+   * WMS
+   * WMTS
+   * Vector Tiles
+* Features (search through features descriptions)
 
 ## How
 
 Type the text to search in the locator bar.
 
-If the result is a **WMS layer**, double-clicking on it will try to add it to the map. 
+If the result is a **WMTS layer**, double-clicking on it will try to add it to the map. 
 It might not be possible since some layers are only visible in the geoportal (map.geo.admin.ch).
 In this case, a link will be shown to display the layer in the geoportal.
 
+![WMTS layer search](./doc/wmts_search.png)
+
 If the result is a **location** or **feature**, 
 double-clicking on it will move the map canvas to the result and highlight its position.
 If any further information can be shown, an info window will be shown over the map.
+
+![Feature search](./doc/feature_search.png)
+
+If the result is a **vector tiles layer**,
+double clicking it will add it to the map canvas as another background layer.
+
+![Vector Tiles layer search](./doc/vector_tiles_search.png)
+
+## More
+
+The search is performed through the QGIS [locator bar](https://qgis.org/en/site/forusers/visualchangelog30/#feature-locator-bar).
+
+Configuration is achieved in the main application settings under the `locator` tab. You will be able to:
+* Enable or disable searches (locations, layers, features)
+* Customize prefixes, define if they are default filters (used without prefix)
+* Access to the configuration of the plugin
+* Include or exclude opendata.swiss data from layer searches
+
+In the configuration of the plugin, further customization can be achieved:
+* Language definition (English, German, French, Italian, Rumantsch)
+* CRS definition (project, CH1903 or CH1903+)
+* Defining if the plugin will try to display further information in a tool tip
+* Defining layers used in the feature search
+
+## Who
+
+This plugin has been developped by OPENGIS.ch with friendly support from the [Swiss QGIS User Group](https://qgis.ch).
\ No newline at end of file
diff --git a/doc/feature_search.png b/doc/feature_search.png
new file mode 100644
index 0000000..214a724
Binary files /dev/null and b/doc/feature_search.png differ
diff --git a/doc/vector_tiles_search.png b/doc/vector_tiles_search.png
new file mode 100644
index 0000000..7508426
Binary files /dev/null and b/doc/vector_tiles_search.png differ
diff --git a/doc/wmts_search.png b/doc/wmts_search.png
new file mode 100644
index 0000000..90b610f
Binary files /dev/null and b/doc/wmts_search.png differ