{% 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, or someone gives you an award on your profile. 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 |
| Awards | someone gives you an award on your profile |
| Quiz attempts | someone completes one of your quizzes |

## 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>
