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

# Agent availability statuses

> Create statuses such as Chat only or Lunch that set agents online in chosen teams or offline, and control which statuses agents can pick from their menu.

Availability statuses let agents change where they receive sessions with one click, using a named status such as **Chat only** or **Lunch**. Each status either puts the agent online in a chosen set of teams or takes them offline.

> [!NOTE]
>
> **Settings → Availability Statuses** in your [OpenCX dashboard](https://platform.open.cx/settings/availability-statuses). Viewing requires the **Availability statuses** permission. Creating, editing, reordering and deleting statuses on this page requires write access to **Settings**. Agents can always see and apply their own status.

## Turn on availability statuses

**1. Create your statuses**

Add the statuses your agents need on this page. See [Create a status](#create-a-status).

**2. Switch agents to the status menu**

Open **Settings → Workspace → Agents → Availability statuses** and turn on **Enable availability statuses**. Changing workspace settings requires write access to **Helpdesk settings**. See [Workspace settings](https://docs.open.cx/ticketing/workspace-settings.md).

**3. Hide built-in statuses (optional)**

Turn on **Hide Online** or **Hide Offline** to remove those options from the agent menu. See [Hide Online and Offline](#hide-online-and-offline).

Until **Enable availability statuses** is on, agents do not see your custom statuses. They set their availability with switches instead.

## Create a status

![Adding the availability status Lunch with Sets you offline in Settings, Availability Statuses](https://mintcdn.com/openchat/hiyaCL2S28Hya6Q7/images/ticketing/availability-status-create.gif?s=61fcc80ef25ce486f76f2a26ac7ed107)

Add a Lunch status that sets agents offline, and it appears in the Statuses list.

**1. Open the form**

Click **New status**.

**2. Name it**

Enter a **Status name**, such as **Email & Chat** or **Lunch**.

**3. Choose what it does**

Under **When applied**, pick **Sets you online** or **Sets you offline**.

**4. Pick a color**

Choose a **Color** for the status dot: gray, blue, green, orange or red. It starts as green for online statuses and orange for offline ones until you pick one.

**5. Pick teams**

For **Sets you online**, choose the teams under **Available in teams**. Only teams with support enabled are listed. Click **Create status**.

What a status does when an agent picks it:

| Status | Agent's main availability | Support teams the agent belongs to |
| - | - | - |
| **Online** (built-in) | On | All on |
| **Offline** (built-in) | Off | All off |
| Custom, **Sets you online** | On | Teams in **Available in teams** on, every other support team off |
| Custom, **Sets you offline** | Off | All off |

A status never adds an agent to a team: listed teams the agent is not a member of are skipped. Teams without support enabled are never changed.

> [!WARNING]
>
> A **Sets you online** status with no teams shows **No teams** in the list. Agents who pick it are online but unavailable in every support team, so they receive no automatic team assignments.

## Order, edit and delete statuses

Drag a status by its handle to reorder. Agents see the same order in their menu, between **Online** at the top and **Offline** at the bottom.

* **Editing** the name, color or teams does not change agents who already have the status. The new teams apply the next time an agent picks it.
* **Changing When applied** removes the status from agents who have it. Their availability stays as it was and shows as Online, Offline or Mixed availability.
* **Deleting** a status removes it and clears it from every agent using it, without changing their availability. This cannot be undone.

## How agents set their status

Agents open the menu under their name at the bottom of the sidebar. The same controls appear in the Phone Desk.

> [tab] Statuses on
>
> The status row shows the agent's current status. Hover it to pick **Online**, a custom status, or **Offline**. **Mixed availability** appears when the agent is online but available in only some support teams, for example "Available in Billing and Sales". It shows the current state and cannot be picked.

> [tab] Statuses off
>
> The menu shows an availability switch, a free-text **Status** message, and **Teams Availability** with a switch for each support team the agent belongs to.

**Available for calls** stays a separate switch in both modes. See [Human calling](https://docs.open.cx/phone/human-calling.md).

A picked status is cleared when the agent's availability changes some other way: an admin switches it on [Human routing](https://docs.open.cx/ticketing/human-routing.md), a team switch changes, or the agent joins or leaves a team. The status then shows as Online, Offline or Mixed availability.

## Hide Online and Offline

Both switches sit under **Settings → Workspace → Agents → Availability statuses** and only appear while **Enable availability statuses** is on.

* **Hide Online** removes the built-in **Online** option from the agent menu. Agents who are online still show as Online.
* **Hide Offline** removes the built-in **Offline** option. Agents who are offline still show as Offline.

A hidden option stays visible until at least one custom status of the same kind exists, so agents always have a way to go online and offline.

## Effect on assignment and time tracking

* **Assignment**: automatic team assignment follows the switches a status sets. An agent receives sessions only in teams where they are available and their main availability is on. See [Human routing](https://docs.open.cx/ticketing/human-routing.md).
* **Coming online**: picking a status that turns teams on checks those teams' waiting sessions right away.
* **Existing sessions**: going offline does not take away sessions the agent already has. With session snoozing on, a snoozed session that wakes while its agent is offline returns to the queue unless **Keep assigned agent when recently offline** is on.
* **Workflows**: **Agent Availability Changed** runs when an agent's main availability flips, and **Agent Availability in Team Changed** runs for each team a status turns on or off.
* **Time tracking**: every status change is recorded with the status name. Time in a status counts as available time, not worked time. See [Agent time tracking](https://docs.open.cx/inbox/time-tracking.md).

## Troubleshooting

| Symptom | Likely cause | Fix |
| - | - | - |
| Agents do not see custom statuses | **Enable availability statuses** is off. | Turn it on in **Settings → Workspace → Agents**. |
| An agent picked a status but gets no sessions | The status has no teams, or none of its teams include the agent. | Edit the status and add the agent's support teams under **Available in teams**. |
| The menu shows **Mixed availability** | A team switch was changed outside the status. | Pick a status again to reset all team switches. |
| None of the above | | Contact OpenCX support with the agent's name and the status. |

***

## Related Documentation

> [card] [Human routing](https://docs.open.cx/ticketing/human-routing.md)
>
> Availability and capacity per agent

> [card] [Teams](https://docs.open.cx/teams.md)
>
> Support teams and member availability

> [card] [Agent time tracking](https://docs.open.cx/inbox/time-tracking.md)
>
> Available time next to worked time

> [card] [Workspace settings](https://docs.open.cx/ticketing/workspace-settings.md)
>
> Turn statuses on and hide built-ins


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.