diff --git a/packages/matomo/README.md b/packages/matomo/README.md
index 3b76df2a187624c9071c4b8fca8e3486ac300a0b..678e792936e1487433bdc172c845766d89d78071 100644
--- a/packages/matomo/README.md
+++ b/packages/matomo/README.md
@@ -19,6 +19,9 @@ npm i @dbp-toolkit/matomo
     - example `<dbp-matomo endpoint="https://my-matomo.tld"></dbp-matomo>`
 - `site-id` (required): set to your site id
     - example `<dbp-matomo site-id="456789"></dbp-matomo>`
+- `auth` object: you need to set that object property for the login-status
+  - example auth property: `{'login-status': 'logged-in'}`
+  - note: most often this should be an attribute that is not set directly, but subscribed at a provider
 
 ## Tracking actions