Notifications
Notification types
Your own notification settings live in the app menu under Notifications (the ☰ button in the top-right) — push for this device, the notification types below, and the test notification. Each game also has its own per-channel settings, further down.
- Push — browser push notifications, on by default. Delivery is handled by the server as soon as a message lands, so it works even if the sender closes the app right after sending.
- In-app markers — the count on each game in the Lobby and the dot on Main and each room tab, so you can always tell where new messages are. Always shown.
- Home-screen badge — when the app is installed, the icon on your home screen shows your total unread count. Supported on iOS 16.4+ and desktop; it updates even when the app is closed. On Android the badge is handled by the OS and only shows a dot while a notification is active.
- Email — off by default
- "It's your turn" — a distinct notification when you are the active player
Permission banner
On first load you may see a banner asking to enable push notifications. Accept it to stay in the loop when you're away.
You don't have to keep watching the toggle: if a device's subscription is ever dropped (browsers rotate and expire them on their own), simply opening the app again re-enables notifications for that device.
Android support
On Android, the phone can block notifications separately from the website.
- Chrome installs the app as its own app — look for RoleByPost in Settings → Apps → RoleByPost → Notifications and allow it there.
- Firefox's "Add to home screen" is only a shortcut inside Firefox, not a separate app, so there is nothing to allow for RoleByPost — allow notifications for Firefox itself instead.
Android can also hold a push back while the phone is asleep, even with everything allowed, so a ping may arrive late rather than immediately.
Checking this device
Send test notification sits under Notifications → Push Notifications on this device, and only appears once push is switched on for this device and your browser allows notifications. It shows a notification right away and checks that the display works — nothing is sent to your phone, so it can't tell you whether a chat ping was delayed.
If the button is not there, switch push on first; if your browser has blocked notifications, allow them in the browser's site settings. If nothing appears after tapping it, the phone is blocking notifications for the app, and on an installed Android app the screen tells you where to allow them.
iOS support
On iOS, push notifications require installing the app to your Home Screen — iOS only exposes the Push API inside installed web apps. The UI shows install guidance and disables push controls until the app is installed. For the home-screen badge to show, Badges must be enabled under iOS Settings → Notifications → the app.
The home-screen badge counts your unread messages in channels and rooms you can see (archived channels don't count) plus any unread admin messages, and it refreshes every time you open the app. Its setting, Show App Icon Badge, controls that icon number only — the markers inside the app stay visible. If the icon ever shows a number after you've read everything, turn Badges off and back on in iOS Settings → Notifications → the app — that flushes a badge the phone itself got stuck on.
Per-channel settings
Each member controls which notifications they receive for each channel, from the Notifications item in the channel sidebar:
- All new messages
- GM messages only
- "It's your turn" alerts
Written by Alvaro Cavalcanti, creator of Role by Post.