Skip to main content

Channel Title

A title row can appear at the top of the thread, distinct from the bot-name header (the title prop). It's a good place to show what the current channel is about — a ticket number, a conversation topic, etc.

Channel Title

A title row can appear at the top of the thread, distinct from the bot-name header. It is seeded by the channelTitle prop (usually from channelMetadata()) and updates live from the backend title.update event. Customize it with renderTitle, or hide it with channelTitleHidden.

Display mode

<Chatbot
  channelTitle="訂單 #1024 諮詢"
  config={{ botProviderEndpoint: '...' }}
  customChannelId="my-channel"
/>
Loading chatbot...
PropTypeDescription
channelTitlestring | nullSeed for the title (usually from channelMetadata()); updates live from the backend title.update event. null = unnamed
renderTitle(props) => ReactNodeReplace the title row entirely. props is { title, renderDefault }; return null to hide
untitledLabelstringFallback text when unnamed (null), default 新對話
channelTitleHiddenbooleanHide the title row entirely

Live Updates​

The title is backed by a reactive store: it updates automatically when the backend emits asgard.channel.title.update, with no manual re-render. Headless consumers can subscribe with the useChannelTitle(channel) hook — see Headless.

See Also​