diff --git a/README.md b/README.md
index dc154d2..8c87671 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@ This extension is heavily inspired by the home assistant extesnsion for ulaunche
 
 To use this extension, you need the Python `requests` library: 
 
-```
+```bash
 pip install requests
 ```
 
@@ -19,8 +19,17 @@ pip install requests
 You need to specify the URL and [API Key](https://developers.home-assistant.io/docs/api/rest/¦) of your Home Assistant instance in the configuration file (e.g. location: `$HOME/.config/albert/homeassistant_config.json`).
 You can generate a new long lived API Key by clicking your name in the bottom left in the Home Assistant UI.
 
+The item order is based on the entity class. Lights and switches are shown first, then scenes etc. You can change the order in the configuration file with `sort_order`. See the default sorting order below:
+```json
+{   ...
+    sort_order: {"light": 1, "switch": 1, "scene": 2, "group": 2, "automation": 3}
+}
+```
+
 ## Usage
-`<trigger> <entity search>`
+```
+<trigger> <entity search>
+```
 
 You can see the actions by pressing the `alt` key.
 
@@ -28,7 +37,6 @@ You can see the actions by pressing the `alt` key.
 
  - renew icons (.svg)
  - test more device classes and adjust which service to call
- - sort items: name matching first
 
 ## Contributing