---
title: Statuses
summary: 'An availability state users can pick in the status changer (Available, In a meeting, Lunch). Each carries an availability group that decides how call routing treats users in this state.'
section: features
tags:
  - crud
  - tempus
  - telephony
  - presence
updated: '2026-08-12'
---

> A **status** is one of the availability states your users pick in the status changer. Each carries an **availability group** that tells call routing how to treat the user, plus optional flags for side-effects like DND or lunch tracking.

## Overview

You manage statuses centrally here. Users pick them from the status changer in the Voxbi app or via a [phone button](phone_buttons.md). A status lives in two worlds: in telephony its availability group decides whether queues ring the user, and in Tempus some flags change how the time is recorded for reporting.

## What it does

Call routing inspects the **availability group**, never the status name. Every status belongs to one of five groups.

| Group | Call routing | Typical examples |
|---|---|---|
| **Available** | Receives queue calls, BLF shows green | Available, At desk |
| **Meeting** | Shows busy on BLFs, some queues skip | In a meeting, Client call |
| **Busy** | Shows busy, queues skip | Focus mode |
| **Away** | Shows away, queues skip, calls may forward | Quick break, Coffee |
| **Unavailable** | Skipped by all queues | Lunch, End of day |

Behavioral flags stack on top. A Lunch status with *Add to lunch time* and *Activate DND* both records lunch time in Tempus and silences calls.

| Flag | Effect |
|---|---|
| **Add to lunch time** | Time counts as lunch in Tempus reporting. |
| **Activate DND** | Turns on Do not disturb while the status is active. |
| **Enable call ringing** | Lets calls ring despite the user's right-to-disconnect setting. |
| **Payable** | Time counts as paid work hours. |

The sub-status section picks which [sub-statuses](tempus_sub_statuses.md) appear under this status, and whether the user may pick several or must pick one.

> [!IMPORTANT]
> The availability group, not the name, drives routing. A status named "At the gym" in the **Available** group still receives queue calls. Pick the group that matches the intent.

## See also

- [Sub-statuses](tempus_sub_statuses.md) - optional refinements under a status.
- [Status changer layouts](tempus_layouts.md) - which statuses appear on which devices.
- [Users](users.md) - the people who pick statuses.
- [Queues](queues.md) - queues can skip members by status group.

```yaml fields
name:
  label: Name
  tab: General
  hint: 'Display name shown to users in the status changer and throughout the system.'
availability:
  label: 'Status group'
  tab: General
  hint: 'Availability group that decides how call routing treats users in this status.'
  values:
    -
      value: available
      label: Available
      text: 'User receives queue calls and shows as available.'
    -
      value: meeting
      label: Meeting
      text: 'Visible as busy on BLFs. Some queues may skip.'
    -
      value: busy
      label: Busy
      text: 'Visible as busy. Queues skip this user.'
    -
      value: away
      label: Away
      text: 'Visible as away. Queues skip. Calls may forward.'
    -
      value: unavailable
      label: Unavailable
      text: 'Completely skipped by all queues.'
ring_users_despite_right_to_disconnect:
  label: 'Ring users despite right to disconnect'
  tab: General
  hint: 'Only has an effect on statuses in the Unavailable group. A user who has turned on right to disconnect stops receiving twinning calls while in an Unavailable status; turn this on to let their twinnings ring anyway.'
description:
  label: Description
  tab: General
  hint: 'Optional context shown to users picking this status, explaining when to use it.'
bg_color:
  label: 'Background color'
  tab: General
  hint: 'Background color representing this status in the changer and layouts.'
font_color:
  label: 'Font color'
  tab: General
  hint: 'Text color displayed on top of the background for readability.'
icon_class:
  label: Icon
  tab: General
  hint: 'Icon shown next to the status name in the status changer.'
flags:
  label: Flags
  tab: General
  hint: 'Behavioral flags that stack on top of the availability group, such as adding time to lunch tracking, activating DND, or marking time as payable.'
allow_multiselect:
  label: 'Allow users to select more than one sub-status'
  tab: General
  hint: 'When on, users can select more than one linked sub-status simultaneously when activating this status.'
sub_status_selection_mandatory:
  label: 'Force the user to select a sub-status'
  tab: General
  hint: 'When on, the user must pick at least one sub-status before the status becomes active.'
subStatuses:
  label: 'Link sub-statuses'
  tab: General
  hint: 'Sub-statuses available under this parent. Users see these as additional options when they pick this status.'
mapping_id:
  label: Mapping
  tab: General
  hint: 'External identifier used to keep this status in sync with integrations such as DSK or Tempus V1.'
locations:
  label: Locations
  tab: General
  hint: 'Locations where this status is available for selection. Leave empty to allow the status on all locations.'
payable:
  label: Payable
  hint: 'Whether time spent in this status counts as paid.'
```