---
title: 'Do not disturb (DND)'
section: features
summary: 'DND rules block incoming calls for a user, optionally limited to internal or external calls and a specific caller identity.'
updated: '2026-08-12'
---

> A **DND rule** marks incoming calls for a user as blocked, so the telephony platform can stop them from ringing the phone.

## Overview

DND rules live on a user. Each rule sets a type (internal or external) and, for external rules, can be narrowed to a single caller identity. A rule can be paused without deleting it, and you can create more than one to cover different cases. The telephony platform carries out the actual blocking, and any further handling of a blocked call (such as a matching "On DND" forward) is configured separately in the user's forwards.



## See also

- [User forwards](user_forwards.md) - configure where calls go when DND is active.
- [Users](users.md) - the parent entity for DND rules.

```yaml fields
status:
  label: Enabled
  api: status
  tab: 'Call preferences'
  hint: 'Whether this DND rule is currently blocking calls. Toggle off to pause without deleting the rule.'
type:
  label: Type
  api: type
  tab: 'Call preferences'
  hint: 'The call direction this rule applies to.'
  values:
    -
      value: internal
      label: Internal
      text: 'Applies to calls from within the PBX.'
    -
      value: external
      label: External
      text: 'Applies to calls arriving from outside the PBX.'
caller_identity_id:
  label: 'Phone number'
  api: caller_identity_id
  tab: 'Call preferences'
  hint: 'Narrows this rule to one caller identity so only calls arriving on that number are blocked. Only available when Type is External.'
  when: 'Type is External'
```