Docs/Help/Widget

Widget

Embedding Surface

Web Component DeliveryChannel Widget is delivered through the pusaka-container web component script hosted by the platform.
Agent BindingWidget instance is tied to a specific agent through data-agent-id, so each embed points to one configured agent context.
Inline Render ModeDefault render mode mounts the chat container inside normal page layout and follows parent element dimensions.
Floating Render ModeOptional floating mode renders a fixed launcher and expandable chat panel independent of document flow.

Core Display Parameters

data-themeDefines visual theme behavior (system, light, or dark) for widget appearance.
data-app-modeControls chat UI scope (full-app for broader interface or chat for chat-focused surface).
data-enable-autofocusControls whether input focus is applied automatically after widget load and reply cycles.
data-chat-titleSets the header title shown in floating chat panel mode.

Floating Layout Parameters

data-positionSets floating launcher corner position (bottom-right, bottom-left, top-right, top-left).
data-offset-xDefines horizontal offset distance between floating launcher and viewport edge.
data-offset-yDefines vertical offset distance between floating launcher and viewport edge.
data-chat-widthConfigures floating panel width with CSS length values and responsive behavior on small viewports.
data-chat-heightConfigures floating panel height with CSS length values.

Integration References

Plain HTML ReferenceCMS provides HTML reference patterns for direct script and tag usage in non-framework pages.
React + TypeScript ReferenceCMS includes React/TypeScript reference for custom element typing and component usage.
Floating in React ReferenceCMS documents that floating behavior is self-managed by the component when data-mode="floating" is used.