Docs/Help/Appearance

Appearance

Theme Selection

Theme PresetsBuilt-in preset themes for quick visual configuration.
Custom Theme ModeEnables full manual control of color tokens and overrides.
Light/Dark Preview ToggleSwitches editing/preview context between light and dark mode surfaces.
Reset All ColorsRestores generated and override colors to baseline theme values.

Base Color System

Primary Base ColorCore brand/action color used to derive major interaction tokens.
Accent Base ColorComplementary emphasis color used for links and highlight tokens.
Neutral Base ColorFoundation color used for borders, icons, and muted UI states.
Surface Base ColorBase background/surface color used for panels and layout fills.
Derived Color ScalesBase colors generate multiple tonal steps to build full design token sets.

General Appearance Controls

Font SizeNumeric setting for global widget text scale.
Font URLExternal font source URL input (for example hosted web-font source).
Font FamilySelect/autocomplete field for default font family in widget UI.
Body Background ColorBackground color token for main widget body area.
Gutter/Container ColorColor token for spacing or container context around main content area.

Component Overrides

Top Bar ColorsControls top/header background and text colors.
Agent Bubble ColorsControls agent bubble background, text, and reference text colors.
User Bubble ColorsControls user bubble background and text colors.
Input Box ColorsControls input background, text, border, and focused-border colors.
Send Button ColorsControls enabled/disabled/hover states for send button background and icon.
Suggestion ColorsControls suggestion chip background, text, arrow, and hover colors.
CTA and Utility ColorsControls action surfaces such as CTA button, spinner, and related visual elements.
Uploaded Files Area ColorControls background/tone for uploaded files display section.

Override Management Behavior

Override LockLocks a token override to prevent auto-regeneration from replacing it.
Section-level ResetResets overrides within a specific category without resetting all appearance values.

Advanced CSS

Custom CSS EditorCode editor for additional CSS rules beyond standard token controls.
Generated CSS SegmentSystem-generated CSS variable block managed by the theme engine.
Manual CSS SegmentUser-maintained CSS area intended for custom styling rules.
Preview-aware StylingCSS updates are reflected in preview to validate visual outcomes before final usage.