{% set uname = user.get('username') if user else 'YOUR_USERNAME' %}
<div class="docs-content" data-render>
# Notification settings
DevPlace notifies you when something involves you: a comment on your post, a reply to your comment, a
mention, an upvote on your work, a new follower, a direct message, a badge, a level-up, or an update
on an issue you filed. You decide which reach you, and how.
Each notification type is delivered on three independent channels:
- **In-app** - the notification appears on DevPlace (the bell in the top navigation and the
`/notifications` page). While you have DevPlace open, an enabled in-app notification also raises a
live, click-through toast in real time, and the unread bell and message badges update instantly,
so you see it without reloading.
- **Push** - a native web push notification is sent to the devices where you enabled push.
- **Telegram** - the notification is delivered to your paired Telegram chat. This channel works only
once you have connected Telegram, and it is **off by default** for every type.
The channels are independent: you can keep a type in-app but silence its push (or the reverse), and
enable Telegram for only the types you care about. The live toast rides the in-app channel: silence a
type's in-app box and it neither lands in your bell nor pops a toast.
## Where to find it
Open your profile and choose the **Notifications** tab, or go straight to
`/profile/{{ uname }}?tab=notifications`. The tab is private: only you (and administrators) can see or
change your settings.
Each notification type is one row with three switches, **In-app**, **Push**, and **Telegram**. The
Telegram switch stays disabled until you connect Telegram. Ticking or unticking a switch saves
immediately - there is no separate save button.
## What each type covers
| Type | Fires when |
|------|------------|
| Comments | someone comments on your post |
| Replies | someone replies to your comment |
| Mentions | someone mentions you with `@username` |
| Upvotes | someone `++`'d your post, comment, project, or gist |
| Followers | someone starts following you |
| Direct messages | someone sends you a message |
| Badges | you earn a badge |
| Level-ups | you reach a new level |
| Issue tracker | there is an update on an issue report you filed |
| Reminders | a reminder or scheduled task you asked Devii to run fires |
| Farm raids | someone steals a ready build from your Code Farm |
## Defaults
In-app and push are **on** for every type until you turn them off, so notifications work out of the
box; Telegram is **off** by default and delivers only once you connect it. A type you have never
changed follows the platform default; once you change a switch, your choice is remembered and no
longer follows later changes to the default.
Use **Reset to defaults** at the bottom of the tab to clear all of your choices and return to the
platform defaults.
## Turning push on
Toggling **Push** for a type only takes effect once you have enabled push notifications on the device
with the bell-with-slash button in the top navigation or on the `/notifications` page. Until then,
push has nowhere to be delivered. Likewise, the **Telegram** switch only delivers once you have paired
Telegram - see [Devii on Telegram](/docs/telegram.html) to connect your account.
## Ask Devii
You can change these settings in plain language through the Devii assistant:
> Turn off push notifications for upvotes.
> Stop notifying me about new followers entirely.
Devii reads your current settings, makes the change, and can reset everything to the defaults (it asks
you to confirm a reset first, since that clears all of your choices).
</div>
<div class="devii-doc-cta">
{% if is_admin(user) %}
<a href="/admin/notifications" class="sidebar-link">Notification defaults (admin)</a>
{% endif %}
</div>