diff --git a/README.md b/README.md
index 81fd72d..0990b70 100644
--- a/README.md
+++ b/README.md
@@ -10,8 +10,11 @@ Iris pairs with your running `hermes gateway` over a private WebSocket and gives
 - **Absolute Privacy!** — everything stays on your own infrastructure
   (push: ntfy by default; FCM is opt-in and routes push metadata via Google —
   see [Push notifications](#push-notifications))
-- **No file limit**
-- **No character limit**
+- **100 MB file uploads by default** — configurable on the gateway via
+  `max_upload_bytes` (see [Media](docs/07-media.md) §7.7); all limits are set
+  on the gateway side (hermes), not in the app
+- **No 4,096-character message limit like Telegram** — messages travel over
+  your own gateway (hard frame-body cap: 1 MiB)
 - **Full markdown support** — tables, checkmarks, bold, inline code, code blocks + syntax highlighting…
 - **HTML Artifact Preview** — agent-sent HTML/CSS/JS rendered in an in-app WebView
 - **All settings live in the app**, not in hermes `config.yml`! Change everything on the fly.
diff --git a/docs/playstore-listing.md b/docs/playstore-listing.md
index ef87386..430eee0 100644
--- a/docs/playstore-listing.md
+++ b/docs/playstore-listing.md
@@ -23,8 +23,9 @@ threads, media, search — Telegram-quality, on your own infrastructure.
   **Google's servers**. If you want truly private communication, use ntfy
   (self-hosted) instead — it is the default.
 
-No file limit. No character limit. Full markdown + HTML artifact preview.
-All settings live in the app.
+100 MB file uploads by default (configurable on your gateway). No
+4,096-character message limit like Telegram. Full markdown + HTML artifact
+preview. All settings live in the app.
 
 Runs on Android and desktop (Linux, macOS, Windows) from one shared codebase.