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

# Personalization and My Profile

> Set your own dashboard appearance and inbox preferences, and choose the name, photo and alias your teammates and customers see in OpenCX.

**Settings → Personalization** holds your own preferences: how the dashboard looks and how the inbox behaves for you. **Settings → My Profile** sets who you are in this workspace: the name, job title and photo your teammates and customers see, and an optional alias shown to customers instead. Nothing on either page changes what your teammates see in their own dashboards.

> [!NOTE]
>
> **Settings → Personalization** in your [OpenCX dashboard](https://platform.open.cx/settings/personalization) is open to every member. [**Settings → My Profile**](https://platform.open.cx/settings/profile) requires read access to **Personal profile** in [Roles](https://docs.open.cx/security/roles.md). Saving your profile or alias requires write access to **Personal profile** or **Members**.

## Change how the dashboard looks

**Appearance** is saved in this browser only. On another browser or computer, you start from the defaults.

![Changing Theme to Dark in Settings, Personalization, then Page to Midnight and Grays to Warm](https://mintcdn.com/openchat/hiyaCL2S28Hya6Q7/images/settings/personalization-appearance.gif?s=ddb21ee7dc55b4fe4e464ca96850b2f0)

Switch the theme to Dark, then pick a deeper page and warm grays. Saved in this browser only.

| Setting | Options | Default |
| - | - | - |
| **Theme** | **Light**, **Dark**, or **System** to follow your device | **Light** |
| **Page** | In light mode, **Ink** (a grey page with white cards) or **Paper** (a whiter page). In dark mode, **Night**, **Midnight** or **Dim**, for how deep the page sits. | **Ink** / **Night** |
| **Grays** | **Gray**, **Warm**, **Cool** or **Blue**, the tint of every surface and border | **Gray** |
| **Contrast** | **Standard**, or **High** to draw text and edges further from the page | **Standard** |
| **Tables** | Dark mode only: **Recessed**, **Outline** or **Bezel**, the well around table rows | **Recessed** |

Only the options for the mode you are in are shown. **Reset to default** appears once you change an option; it resets **Page**, **Grays**, **Contrast** and **Tables**, and leaves **Theme** as it is. You can also switch theme from the command menu with **Change theme…**.

## Set your inbox preferences

The **Inbox** section is saved to your account, so your choices follow you across browsers and workspaces.

| Setting | What it does | Default |
| - | - | - |
| **Show views in sidebar** | Views sit beside the session list. Small screens use a dropdown. | Your workspace default |
| **Open sessions in tabs** | Each session you open gets a tab above the session pane. | Your workspace default |
| **Open the next session assigned to you after closing one** | When you close the session you are viewing, the next open session assigned to you in the list opens. Off: you stay on the session you just closed. | Off |
| **Compact session cards** | Hides the last message line on each session card, so more sessions fit on screen. | Off |
| **Pin composer toolbar** | Keeps formatting and AI Copilot controls above the message composer. Off: the toolbar appears when you select text. | Off |
| **Macros button** | Adds a macros button to the composer that opens a searchable list of your macros with a preview. Macros leave the **/** menu. Off: insert macros from the **/** menu. | Off |
| **Suggested macros** | Lists the macros that best fit the customer's latest message first in the **/** menu and the macro picker. Off: macros stay in title order. | Off |

**Show views in sidebar** and **Open sessions in tabs** follow the defaults an admin sets in [workspace settings](https://docs.open.cx/ticketing/workspace-settings.md#what-agents-can-override) until you change them. While you follow the default, the row says **Following your workspace default.** Once you change it, select **Use workspace default** to follow it again.

**Suggested macros** works only while your workspace allows it. If an admin turned it off under **Settings → Workspace → Replies**, the switch is disabled with the note **Turned off for this workspace by an admin.** More on composer behavior and suggestions is in the [inbox guide](https://docs.open.cx/inbox/intro.md#composer-toolbar) and [macros](https://docs.open.cx/ticketing/macros.md).

## Edit your profile

**Your profile** on **Settings → My Profile** applies to this workspace only. Your account name and photo stay as they are, and other workspaces are not affected.

| Field | What it does |
| - | - |
| **Photo** | Shown to your teammates and customers in this workspace, unless you have an alias. Select **Upload** to change it, or **Remove** to fall back to your account photo. |
| **Display name** | Your name in this workspace, up to 100 characters. Leave it empty to use your account name. |
| **Job title** | Shown to customers in emails whose template includes it, also when you have an alias. |

Select **Save changes** to apply them, or **Reset** to discard. Until you set an alias, customers see your display name and photo.

## Use a customer-facing alias

A **Customer-facing alias** replaces your name and photo for customers while your teammates keep seeing your profile. Use it when agents should not share their real names with customers.

**1. Name the alias**

Under **Customer-facing alias**, enter an **Alias name**, such as "Alex from Support", up to 100 characters.

**2. Add a photo (optional)**

Select **Upload** under **Alias photo**. Without one, customers see the alias's initials, never your own photo.

**3. Save**

Select **Save changes**. To stop using it, select **Remove alias**, which clears the name and photo together.

Customers see the alias wherever OpenCX shows them who replied:

* Your replies in the chat widget, including earlier messages in the session history.
* Emails, including agent names in email templates. While an alias is set, templates leave out your email address; your job title still appears if the template includes it.
* Replies sent to connected channels such as Slack, and replies and notes sent to a connected ticketing system.
* The agent-name variable in macros, such as `{{agent.full_name}}`.
* The assignee name that workflows receive for sessions assigned to you.

When **Show agents’ first names only** is on in workspace settings, full names are shortened to the first name, but an alias is always shown in full. Members with write access to **Members** can also set anyone's profile and alias from [Settings → Members](https://docs.open.cx/ticketing/members.md).

## Troubleshooting

| Symptom | Likely cause | Fix |
| - | - | - |
| **My Profile** is not in Settings | Your role has no read access to **Personal profile** | Ask an admin to grant it in [Roles](https://docs.open.cx/security/roles.md), or to edit your profile from members. |
| The alias fields are disabled | Your role has no write access to **Personal profile** or **Members** | Ask an admin to grant it, or to set the alias for you. |
| **Suggested macros** cannot be turned on | An admin turned suggestions off for the workspace | Ask an admin to turn on **Offer suggested macros** under **Settings → Workspace → Replies**. |
| Your theme is different on another computer | **Appearance** is saved per browser | Set it again in that browser. |

***

## Related Documentation

> [card] [Workspace settings](https://docs.open.cx/ticketing/workspace-settings.md)
>
> Defaults for every agent

> [card] [Notification settings](https://docs.open.cx/ticketing/notifications.md)
>
> Alerts and sounds

> [card] [Members](https://docs.open.cx/ticketing/members.md)
>
> Manage teammates and aliases

> [card] [Inbox](https://docs.open.cx/inbox/intro.md)
>
> Composer and views


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