Customizing Avatar Widgets

Customizing Avatar Widgets

On the avatar page you can customize the behaviors, layout, branding, and visual styling of the avatar widget. The widget preview on the left reflects the changes you make, showing how the widget will look when eventually deployed to a website.

Setting	Explanation
Display mode	Controls how the avatar widget is presented on your page. Choose one of four layouts: Embedded — full panel rendered inline within the page; Compact — smaller embedded panel that takes less vertical/horizontal space; Toggler — a floating chat-bubble button in the corner that opens the avatar on click (good for site-wide assistants); Overlay (realtime avatars only) — frameless, transparent rendering that fills its host element with no header/footer chrome, so you can layer the avatar over a hero image, video, or any background and size it entirely with your own CSS.
Captions	When enabled, on-screen text captions are shown for the avatar's spoken responses. Improves accessibility and lets users follow along in noisy environments or when audio is muted.
Barge-in	When enabled, the user can interrupt the avatar mid-sentence simply by speaking — the avatar stops talking and starts listening. When disabled, the user must wait for the avatar to finish before speaking.
UI language	Sets the language of the widget's interface text (buttons, tooltips, status messages, captions UI). Supported: English, French, German, Spanish, Chinese (Simplified), and Arabic. Independent of the conversation language, which is handled by the underlying AI model.
Brand name	Optional brand or company name shown in the widget header. Helps reinforce your identity when the avatar is embedded on a third-party site or shared publicly.
Brand logo URL	Direct URL to a logo image (PNG/SVG/JPG) displayed in the widget header alongside the brand name. Use HTTPS and an image hosted on a domain that allows hot-linking.
Avatar background	Background applied behind the 3D avatar canvas. Accepts any valid CSS background value — a solid color (#0a0a0a), a gradient (linear-gradient(...)), or an image URL (url(...)). Leave blank for the default transparent/neutral background.
Corner radius	Border radius (in pixels) for the widget's outer container, controlling how rounded its corners are. 0 = sharp corners; higher values = more rounded. Ignored in Overlay mode (which has no chrome).
Theme colors	Four customizable CSS color variables that drive the widget's look: Primary color (main accent — buttons, highlights), Secondary color (supporting accent), Text on primary background, and Text on secondary background. Pick contrasting text colors to keep labels legible against your chosen primary/secondary.
Terms of service and privacy policy links	URLs shown in the widget footer linking to your Terms and Privacy pages. Required for compliance when collecting user input or voice data; defaults to Sentifyd's own policies if left blank.
Sizing options	Pixel dimensions for the widget: Canvas width and Canvas height size the avatar (3D scene) area; Chatbot height sets the conversation/transcript panel height. These apply in Embedded, Compact, and Toggler modes (in Toggler mode on small screens the widget expands to full screen regardless). They are ignored in Overlay mode, where the overlay fills its host element and is sized entirely by your own CSS.

Where these settings apply. The settings above are configured on the Avatar Page and saved to your avatar's profile. They are remembered the next time you open the Avatar Page and are also pre-loaded on the Deployment Page so the generated HTML embed snippet reflects them automatically.

Important: these settings only take effect on customer sites that use the generated HTML embed snippet as-is. If you (or your developers) hand-author the <sentifyd-bot> / <sentifyd-realtime> web component without copying the generated attributes, the saved settings are not applied — the attributes you set on the element win.

WordPress deployments are a separate case: the Sentifyd Avatar WordPress plugin has its own settings panel inside the WP admin, and those plugin settings override anything configured here. To customize the widget on a WordPress site, configure it from the plugin's settings page rather than the Avatar Page.