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

# Workspace settings reference

> Every setting under Settings → Workspace, from inbox layout and reply shortcuts to closing rules and session panels, with defaults and what each changes.

**Settings → Workspace** holds the defaults every agent in your workspace works with: how the inbox looks, how replies are sent, how sessions are assigned and closed, how agents appear to customers, and what the session details panel shows. Use this page to find a setting and see what it changes before you turn it on for everyone.

> [!NOTE]
>
> **Settings → Workspace** in your [OpenCX dashboard](https://platform.open.cx/settings/workspace). Members with read access to **Settings** or **Helpdesk settings** can view it. Changing a setting requires write access to **Helpdesk settings** in [Roles](https://docs.open.cx/security/roles.md), which write access to **Settings** also grants. Members without it see the values read-only, labelled as set by your workspace admin.

## What you control

| Category | What you control |
| - | - |
| **Inbox** | Session tabs, contact names and subjects on session cards, panel scrollbars, inbox views, shared view order, and the **Reports & Apps** sidebar |
| **Replies** | Which key sends a message, the **Send and set status** menu and its shortcut, suggested macros, and the emoji picker |
| **Sessions** | Snoozing, automatic assignment, fields required to close a session, sub-session defaults, and session priority |
| **Agents** | First names for customers, availability statuses, and customer reply notifications |
| **Session details** | Hidden attributes, pinned attributes and how many show, and the order of cards in the session details panel |

Every setting applies to the whole workspace. Only two of them are defaults agents can change for themselves; see [What agents can override](#what-agents-can-override).

## Find a setting

![Searching Settings, Workspace for emoji and turning on the Emoji picker switch](https://mintcdn.com/openchat/hiyaCL2S28Hya6Q7/images/ticketing/workspace-settings-search.gif?s=dfb82906acee9466b650f3095968b59b)

Search for emoji, find Emoji picker and switch it on for the whole workspace.

Pick a category tab, or type in **Find a workspace setting…** to search all five categories at once. Press **/** anywhere outside a text field to jump to the search box, and **Escape** in the box to clear it.

Switches and pickers save as soon as you change them. Number fields, such as the offline threshold and truncation limits, save when you leave the field or press **Enter**. Every change is recorded in the [audit log](https://docs.open.cx/security/audit-logs.md) with its old and new value.

> [!NOTE]
>
> **Session snoozing** and **Session priority** appear only when your workspace uses native OpenCX ticketing. With another ticketing system, those sections are hidden and search does not find them.

## Inbox

The **Hide contact name** and **Show summary as subject** rows, like the other per-channel settings on this page, list Web, Email, WhatsApp, Instagram, Messenger, Slack, SMS, API and Internal. Voice channels are not listed.

| Setting | What it changes for agents | Default |
| - | - | - |
| **Open sessions in tabs by default** | Each opened session gets a tab above the session pane. Agents can override it in Personalization. | On |
| **Show contact names in session tabs** | Tabs show the contact's name instead of the session number. Sessions without a name keep their number. Only shown while tabs are on by default. | Off |
| **Show inbox panel scrollbars** | Scrollbars appear when you hover over the session list or session details and there is more to scroll. | Off |
| **Show summary as subject** | In the selected channels, session cards, headers and tabs show the AI summary as the subject. For email, it replaces the original subject. | No channels |
| **Hide contact name** | In the selected channels, session cards and the session header hide the contact name. It only takes effect where a fallback exists: the email subject, or the AI summary when **Show summary as subject** is on for that channel. | Shown in all channels |
| **Show views in sidebar by default** | Views sit beside the session list instead of in a dropdown. Smaller screens always use the dropdown. Agents can override it in Personalization. | Off |
| **Hide default inbox views** | Removes the built-in **All sessions** and **Assigned to me** views. Only custom and shared views remain. | Off |
| **Shared views order** | Drag categories and shared views into the order everyone sees in the inbox. Personal views are not listed and keep each agent's own order. Views you have not arranged appear after the arranged ones. | Not arranged |
| **Reports & Apps sidebar** | Select **Add** to pin pages and mini apps under **Reports & Apps**, drag to reorder, and remove with **×**. Each person sees only the entries they can open. | **Impact Dashboard** only |

In **Shared views order**, the pencil and trash icons on a category rename or remove it on every shared view that uses it. They appear only if you also have write access to **Shared inbox views**. Views sidebar behavior, categories and filters are covered in the [inbox guide](https://docs.open.cx/inbox/intro.md#views-sidebar).

## Replies

| Setting | What it changes for agents | Default |
| - | - | - |
| **Send message shortcut** | In the selected channels, **Enter** sends the message. Everywhere else, agents press **⌘ + Enter** on Mac or **Ctrl + Enter** on Windows and Linux. | **⌘/Ctrl + Enter** in all channels |
| **Statuses in the Send menu** | Each selected custom status appears as **Send and \[status]** beside **Send and resolve**, in the order you add them. Statuses that close the session follow the same closing rules. | None |
| **Send and resolve shortcut** | The key combination that sends a reply and resolves the session. Select **Change**, press the new combination, then **Save shortcut**. Combinations already used elsewhere are rejected. | **Cmd + Shift + Enter** on Mac, **Ctrl + Shift + Enter** on Windows and Linux |
| **Offer suggested macros** | Allows suggested macros for the workspace. Each agent still turns them on for themselves in Personalization. Off: nobody sees suggestions. While on, the row shows how often suggestions were shown and used recently. | On |
| **Emoji picker** | Adds a smiley button to replies, internal notes and new sessions. | Off |

The status picker lists your [custom statuses](https://docs.open.cx/ticketing/custom-statuses.md) grouped under **Open**, **Resolved** and **Unresolved**. If it is empty, create statuses under **Settings → Custom Status** first. See [Send and resolve](https://docs.open.cx/inbox/intro.md#send-and-resolve) for what agents see in the composer, and [macros](https://docs.open.cx/ticketing/macros.md) for how suggestions are ranked.

## Sessions

### Session snoozing

Native OpenCX ticketing only.

| Setting | What it changes for agents | Default |
| - | - | - |
| **Enable session snoozing** | Adds **Snooze** to session statuses and a **Snoozed** inbox view. Snoozed sessions free agent capacity while SLAs keep running. Turning it off brings snoozed sessions back to the inbox. | Off |
| **Keep assigned agent when recently offline** | When a snoozed session wakes and its assignee is offline, it normally returns to the queue. With this on, the assignee keeps it if they have been offline for less than the threshold. | Off |
| **Offline threshold (hours)** | Whole hours, at least 1. Checked only when the session wakes. At or above the threshold, or when the offline time is unknown, the session returns to the queue. | 12 |

A session wakes when, for example, its snooze time arrives, the customer replies, an SLA breaches, or a workflow reopens it; the threshold is checked then. An agent opening it manually keeps its assignment. Details are in [Snooze a session](https://docs.open.cx/inbox/intro.md#snooze-a-session).

### Assignment

| Setting | What it changes for agents | Default |
| - | - | - |
| **Auto-assign on typing** | In the selected channels, the session is assigned to an agent as soon as they start typing a reply. | No channels |
| **Assign on reply** | Replying to a session assigns it to the agent who replied. Off: the current assignee stays, and agents can still assign manually. Taking over from the AI still assigns the session. | On |

### Closing sessions

| Setting | What it changes for agents | Default |
| - | - | - |
| **Require Structured Fields to close** | Agents must fill the fields you select before moving a session to a closed status. Pick up to 50 fields from the dropdown beside the switch. | Off |
| **Team exceptions** | Select **Add team**, choose a team and its own **Team fields**, and decide whether it also needs the workspace fields with **Also require workspace fields**. Teams not listed use the workspace fields. | None |

Only human agents closing from the inbox are held back. Sessions closed by the AI agent, workflows or integrations are not affected. A session follows the requirements of the team it belongs to, and a session without a team uses the workspace list. **Team exceptions** appears once your workspace has teams and can be edited only while the switch is on. See [Require fields before closing a session](https://docs.open.cx/ticketing/structured-fields.md#require-fields-before-closing-a-session).

### Sub-sessions

| Setting | What it changes for agents | Default |
| - | - | - |
| **Auto-fill contact on sub-session creation** | New sub-sessions start with the parent session's contact already picked. Agents can still swap the recipient. Off: the recipient starts empty and the parent's contact is offered as **Use parent session contact**. | On |

### Session priority

Native OpenCX ticketing only.

| Setting | What it changes for agents | Default |
| - | - | - |
| **Enable session priority** | Shows priorities in the inbox, workflows and team assignment. Turning it off restores default assignment without clearing saved priorities. | Off |
| **Prioritize across Priority-first teams** | For agents in several Priority-first teams, picks the highest-priority eligible session across those teams. Each team keeps its assignment delay. Shown while priority is on. | Off |
| **Custom priorities** / **Priority order** | Select **Add priority** to create a level such as VIP, then drag levels into order, highest first. **None** always stays lowest. Removing a level asks for a replacement. | Standard levels only |

Reordering applies to waiting sessions; existing assignees stay the same. See [Set session priority](https://docs.open.cx/inbox/intro.md#set-session-priority) and [cross-team priority](https://docs.open.cx/teams.md#prioritize-across-teams).

## Agents

| Setting | What it changes for agents | Default |
| - | - | - |
| **Show agents’ first names only** | Customer-facing names, generated signatures and session exports use the agent's first name. Aliases stay unchanged, and teammates still see full names. | Off |
| **Enable availability statuses** | Agents pick a status from a list you configure instead of flipping an availability switch. | Off |
| **Hide Online** / **Hide Offline** | Removes the built-in Online or Offline status from the agent status menu. Each stays visible until a custom status of that type exists. Shown while availability statuses are on. | Off |
| **Disable customer reply notifications** | Agents no longer get a notification when a customer replies to a session assigned to them. | Off |

Configure the statuses themselves in [availability statuses](https://docs.open.cx/ticketing/availability-statuses.md). For what first names change in detail, see [Agent first names](https://docs.open.cx/inbox/intro.md#agent-first-names). How the reply notification switch interacts with each agent's own choices is covered in [notification settings](https://docs.open.cx/ticketing/notifications.md).

## Session details

| Setting | What it changes for agents | Default |
| - | - | - |
| **Hidden attributes** | Session, contact and company attributes whose key matches a pattern are hidden from inbox session panels. `qa_*` hides keys starting with `qa_`, `*debug*` hides keys containing `debug`. `*` is the only wildcard, and matching ignores case. | No patterns |
| **Attribute display** | **Pin an attribute key** puts that attribute at the top of attribute lists, in the order you drag them. Pinned company attributes also lead the company page and always show as columns on the companies list. | No pins |
| **Truncation limit** | How many attributes show before **Show more**, per entity. Pinned attributes take the first slots. Minimum 5. | 10 |
| **Session details cards** | Drag cards to reorder the session details panel, and use each switch to hide or show a card. **Reset to default** restores the built-in order. | Built-in order, **Session notes** off |

Hidden attributes declutter the inbox; they are not access control. Matching keys can still appear in filter options, exports, and the contact and company pages. Each list holds up to 200 patterns of up to 200 characters.

The card list shows only cards your workspace can use, such as a ticket link card for your connected ticketing system. Most cards appear in a session only when they have something to show. If widgets are placed in the panel, **Reset to default** asks first, because it removes them too. You can also arrange the panel from a session with **Adjust widgets**; see [Session sidebar layout](https://docs.open.cx/inbox/intro.md#session-sidebar-layout).

## What agents can override

Two settings are defaults that each agent can change in [Personalization](https://docs.open.cx/ticketing/personalization.md): **Open sessions in tabs by default** and **Show views in sidebar by default**. An agent who never changes them follows the workspace value, and can return to it with **Use workspace default**.

Suggested macros work the other way round. Agents opt in for themselves, and **Offer suggested macros** turned off here overrides every agent's choice. All other settings on this page apply to everyone and cannot be changed per agent.

## Troubleshooting

| Symptom | Likely cause | Fix |
| - | - | - |
| Switches are disabled and the page says the defaults are set by your workspace admin | Your role has neither **Helpdesk settings** (Write) nor **Settings** (Write) | Ask an admin to add **Helpdesk settings** (Write) in [Roles](https://docs.open.cx/security/roles.md). **Settings** (Write) includes it. |
| **Session snoozing** or **Session priority** is missing | Your workspace is not on native OpenCX ticketing | These sections are available only with native OpenCX ticketing. |
| **Hide contact name** has no effect in a channel | Sessions in that channel have no subject to show instead | Turn on **Show summary as subject** for that channel. Email sessions use their subject. |
| The **Statuses in the Send menu** picker is empty | No custom statuses exist yet | Create them under **Settings → Custom Status**, then select them here. |

***

## Related Documentation

> [card] [Inbox](https://docs.open.cx/inbox/intro.md)
>
> How agents work sessions

> [card] [Personalization](https://docs.open.cx/ticketing/personalization.md)
>
> Each agent's own preferences

> [card] [Structured Fields](https://docs.open.cx/ticketing/structured-fields.md)
>
> Fields required to close

> [card] [Roles](https://docs.open.cx/security/roles.md)
>
> Grant Helpdesk settings access


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