> ## 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 Widget Settings
> Configure the floating chat widget, inline activator, appearance, and shopper-facing labels in the Remark dashboard.
Chat widget settings control how shoppers enter and experience Remark on your site. Use these settings to turn chat surfaces on or off, choose how they appear, manage inline activator questions, and customize the text shoppers see.
## Where settings live
| Dashboard page | Use it for |
| ------------------------------------------ | ---------------------------------------------------------------------------------------------- |
| **Settings > Appearance** | Theme colors, fonts, spacing, roundness, z-index, and custom CSS |
| **Settings > Features > Chat** | Floating chat availability, activator style, placement, transfer behavior, animation, and icon |
| **Settings > Features > Inline activator** | Embedded activator setup, page placement, interaction mode, and activator questions |
| **Settings > Features > Labels** | Shopper-facing text overrides for the chat widget and inline activator |
Use [Persona Studio](/dashboard/persona-studio) for how Remark agents speak, and use [Intents](/dashboard/intents) for scenario-specific agent playbooks. Widget settings change the shopper-facing surfaces around the conversation.
## Appearance
The **Appearance** page controls shared theming for the floating chat widget and the inline activator.
| Setting | What it changes |
| ------------------- | ---------------------------------------------------------------------------------------------------- |
| Color scheme | Light, dark, or auto. Auto follows the shopper's system preference. |
| Brand color | The primary color used to generate the default widget palette. |
| Text color | Main text color inside the widget surfaces. |
| Background color | Main surface background color. |
| Button color | Interactive action color, including the send button and floating activator button. |
| Border color | Borders and dividers. |
| Online indicator | Availability indicator color. |
| Error color | Error and critical state color. |
| Font family | Font stack used inside the widget. Popular Google Fonts can be previewed in the dashboard. |
| Font size | Base font size in pixels. Widget typography scales from this value. |
| Padding | Compact, default, comfortable, or a custom pixel value for internal spacing. |
| Border roundness | Square, rounded, circular, or a custom pixel value for corner radius. |
| Use theme in... | Whether the theme settings apply to the **Chat widget**, the **Activator**, or both. |
| Chat z-index | The stacking order for the floating chat widget. Increase this if chat appears behind site elements. |
| Custom styling code | Advanced CSS overrides for the chat widget and inline activator. |
The preview panel includes **Chat** and **Activator** tabs. Check both tabs before saving theme changes, especially when changing color scheme, button color, font size, padding, or border roundness.
### Custom CSS
Use custom CSS only when the dashboard settings are not specific enough. Custom CSS rules must target `remark-chat-widget` or `remark-qa-activator` in their selectors.
For SDK-level styling details, see [Styling & Theming](/sdk/styling).
## Chat settings
The **Chat** page controls the floating chat widget.
| Setting | What it changes |
| ---------------------------------------- | ----------------------------------------------------------------------------------------------- |
| Enable chat | Turns the floating chat widget on or off for site visitors. |
| Turn off chat when no experts are online | Hides the widget when no human experts are available. |
| Allow transfer to human | Controls whether AI can transfer shoppers to a human expert **Always** or **Only when online**. |
| Activator style | Shows the chat entry point as a floating **Button** or **Text bar**. |
| Position of the widget | Places the widget on the left, center, or right. Center is available for the text bar. |
| Enable activator animation | Shows the icon animation on the floating button activator. |
| Activator icon | Replaces the default icon on the floating button. |
Use a solid-color PNG with a transparent background for the activator icon. The dashboard tints the icon to match your widget color, and uploads must be 5 MB or smaller.
If the floating button is selected, the dashboard uses left or right placement. Center placement is available for the text bar activator.
## Inline activator
The **Inline activator** page controls the embedded Remark surface that appears inside page content.
| Setting | What it changes |
| --------------------- | ---------------------------------------------------------------------------------------------------------------- |
| Enable activator | Turns the inline activator on or off. |
| Activator type | Shows a featured expert header or a text-only activator. |
| Interaction mode | Keeps conversations inline or hands the shopper off to the floating chat widget. |
| Inline activator only | Hides the floating chat widget so the inline activator is the only Remark surface on pages where it is inserted. |
| CSS selector | Selects the page element used as the insertion point. |
| Activator position | Inserts the activator before or after the selected page element. |
In **Inline** interaction mode, conversations continue inside the embedded activator. In **Handoff** mode, activator interactions open the floating chat widget. When **Inline activator only** is enabled, conversations stay inline even if handoff mode is selected, and pages without the inline anchor show no Remark chat surface.
### Activator questions
Activator questions are the prompts shown in the inline activator. You can manage questions at three levels:
| Level | Use it for |
| ------- | ------------------------------------------ |
| General | Default questions across the site. |
| Product | Questions for a specific product page. |
| Page | Questions for a specific non-product page. |
All active questions rotate in the inline activator by default. Low-performing questions are automatically archived. You can lock up to three questions so they always appear in the inline activator.
For each question, you can:
* Add, edit, duplicate, archive, or restore the question
* Choose the question icon
* Lock or unlock the question's position
* Reorder locked questions
* View sales and engagement rates
* View an answer when one has been generated
* Mark an answer incorrect so it will not be used in future responses
## Labels
The **Labels** page customizes shopper-facing text in the chat widget and inline activator.
Label overrides apply per language and take effect immediately for new sessions. Use labels for UI copy such as placeholders, buttons, status messages, prompt text, and inline activator prompt icons.
The label editor includes:
* A searchable label tree
* An **Overrides only** filter
* One row per supported language
* Token previews for labels that include dynamic values
* Prompt label and icon editing
* **Auto-translate** when a source override is available
* **Reset** to restore default labels
* **Discard** and **Save changes** for pending edits
Leaving a label blank or resetting it removes the override and returns that language to the default label.
Need help configuring chat widget settings? Contact `support@remark.ai`.