> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ontime.hosai.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Notification preferences

> Eight organization-wide toggles controlling which in-app notifications are created.

export const PermissionNote = ({perm}) => <Info>
    Requires the <code>{perm}</code> permission. Ask your administrator if an
    action described here is missing from your screen — see
    [Roles & permissions](/help/concepts/roles-and-permissions).
  </Info>;

<PermissionNote perm="settings:write" />

**Settings → Notifications.**

Eight independent toggles. Each saves immediately — there is no Save button.

| Toggle                       | Controls                                                        |
| ---------------------------- | --------------------------------------------------------------- |
| **Leave decisions**          | Leave approved and rejected notifications, and comp-off earned. |
| **Regularization decisions** | Regularization approved and rejected.                           |
| **Overtime decisions**       | Overtime approved and rejected.                                 |
| **Swap decisions**           | Shift swap approved and rejected.                               |
| **Messages**                 | New message received.                                           |
| **Punch reminders**          | Reminders to clock in or out.                                   |
| **Payslips**                 | Payslip published when a payroll cycle disburses.               |
| **Form 16**                  | Form 16 available when a batch is distributed.                  |

## These are real, not cosmetic

Turning a toggle off means the notification **is never created** — not created and hidden. The notification platform consults these preferences before writing anything.

<Warning>
  Turning **Payslips** off genuinely silences payslip publication for the whole organization. Employees will still find their payslips in the app; nobody will be told they are there.
</Warning>

## Two types cannot be silenced

<Note>
  **Document verified** has no toggle — there is deliberately no document preference field.

  **Webhook failed** is ungated by design. It is an operational alarm telling `api:manage` holders that an outbound integration has exhausted its retries, and organization preferences must not be able to suppress it.
</Note>

## Scope of the setting

Preferences are **per organization**, not per user and not per channel.

* An individual cannot mute a category for themselves.
* There are no channel options, because there is only one channel: OnTime notifications are **in-app only**. No email, SMS, WhatsApp or web push exists to configure.

For machine-readable delivery of the same events to your own systems, use webhooks — see the **Developers** tab.