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

# Chat shell parts

> Style chat headers, menus, expert profiles, and welcome screens.

[Writing custom CSS](https://docs.remark.ai/sdk/styling/custom-css.md) · [Theme tokens](https://docs.remark.ai/sdk/styling/tokens.md)

## Shared Parts

These parts are shared by both the floating chat and the embedded chat (inline activator).

### Widget Shell

The outermost structural elements that wrap the widget's header, content area, and footer. Combine them with `data-scene` to style each section differently on the landing screen, during an active conversation, or while paused.

| Part | Element |
| - | - |
| `parent-container` | Outermost shadow DOM container |
| `app-parent` | Widget root (floating or embedded) |
| `widget-header` | Header slot |
| `widget-content` | Main content slot |
| `widget-footer` | Footer slot |

### Chat Header

The header bar at the top of the chat, showing brand and expert info. Visible once the widget is open (floating) or always visible (embedded).

| Part | Element |
| - | - |
| `chat-header` | Header content container |
| `chat-header-brand` | Header variant showing the brand logo and name, before a conversation starts |
| `chat-header-expert` | Header variant showing the matched expert |
| `chat-header-avatar` | Expert avatar |
| `avatar-status-indicator` | Online dot on the expert avatar |
| `chat-header-brand-name` | Brand name heading |
| `chat-header-expert-trigger` | Clickable area that opens the expert profile |
| `chat-header-expert-name-row` | Row holding the expert name and the AI or human indicator |
| `chat-header-expert-name` | Expert name heading |
| `chat-header-assistant-indicator` | Icon beside the expert name that marks an AI assistant or a human expert |
| `chat-header-tagline` | Expert tagline |

### Header Menus

Dropdown menus accessible from the header — including options to mute, request a human, and adjust widget layout. The layout menu is only present in the floating chat.

| Part | Element |
| - | - |
| `header-menu` | Menu buttons container |
| `header-menu-button` | Shared on every header action button |
| `header-menu-more-button` | More options icon button |
| `header-menu-close-button` | Minimize or close button |
| `header-menu-open-chat-button` | Open chat button, embedded mode |
| `header-menu-layout-button` | Layout menu trigger |
| `header-menu-cart-button` | Cart button, shown when the shopper's cart has items |
| `cart-icon` | Cart glyph inside the cart button |
| `cart-count-badge` | Item-count badge on the cart glyph |
| `more-options-menu` | More options menu content |
| `more-options-menu-mute` | Mute or unmute item |
| `more-options-menu-speak-to-human` | Speak to human item |
| `layout-menu` | Layout menu content |
| `layout-menu-size` | Size radio group |
| `layout-menu-size-default` | Default size radio |
| `layout-menu-size-expanded` | Expanded size radio |
| `layout-menu-size-full-height` | Full height size radio |
| `layout-menu-align` | Alignment radio group |
| `layout-menu-align-left` | Left align radio |
| `layout-menu-align-center` | Center align radio |
| `layout-menu-align-right` | Right align radio |
| `layout-menu-activator` | Activator style group |
| `layout-menu-activator-text-bar` | Text bar activator radio |
| `layout-menu-activator-button` | Button activator radio |

### Expert Intro

An introductory card shown before the conversation starts. Appears on the landing scene in both compact (embedded) and hero (floating) variants, depending on the activator type setting.

| Part | Element |
| - | - |
| `expert-intro` | Intro container (compact and hero variants) |
| `expert-intro-avatar` | Expert avatar |
| `expert-intro-name` | Expert name heading |
| `expert-intro-tagline` | Expert tagline |

### Paused Scene

Shown in the embedded chat while the visitor's conversation is open in the floating chat on the same page. Displays the matched expert's avatar, a status message, suggested prompts, and a button that moves the conversation into the embedded chat.

| Part | Element |
| - | - |
| `intro` | Intro container |
| `intro-avatar` | Expert avatar |
| `intro-message` | Pause status message |
| `actions` | Actions container |
| `move-conversation-button` | Resume conversation button |

### Expert Profile Drawer

A slide-over panel with the expert's full profile, including bio and credentials. Opens when the visitor clicks the expert in the chat header (`chat-header-expert-trigger`), for experts with a full profile.

| Part | Element |
| - | - |
| `expert-profile-drawer` | Drawer content |
| `expert-profile-drawer-back-button` | Back or close button |
| `expert-profile-drawer-name` | Expert name heading |
| `expert-profile-drawer-assistant-indicator` | AI or Human tag under the expert name |
| `expert-profile-drawer-details` | Row holding the tagline and location |
| `expert-profile-drawer-tagline` | Expert tagline |
| `expert-profile-drawer-details-separator` | Dot between the tagline and location |
| `expert-profile-drawer-location` | Expert location |
| `expert-profile-drawer-bio` | Bio markdown container |

### Welcome Message

The expert's opening message, shown at the start of a new conversation before the visitor sends anything.

| Part | Element |
| - | - |
| `welcome-message` | Welcome message row |
| `welcome-message-avatar` | Welcome message avatar |
| `welcome-message-text` | Welcome message text |


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