Behavior
Behavioral configuration properties control widget interaction, including suggestion pills, height modes, auto-open behavior, query parameter handling, and user context injection.
| Property | Default | Description |
|---|---|---|
| suggestions | [] | Array of prompt pill strings shown before first chat |
| height_mode | med | Default chat body height: slim, med, or long |
| close_after_interact_load | false | Auto-collapse to slim after loading existing chat history |
| auto_open_on_prompt | true | Auto-open widget when zdAgent.send() is called |
| query_params_append | {} | Key-value pairs appended as query params to same-origin links in agent responses |
| user_context | null | Key-value pairs sent with each chat request and injected into the agent's context block |
For height mode recommendations, see Preventing Layout Shift (CLS).