Skip to main content
By default, the watsonx Orchestrate embedded chat widget renders with IBM Blue styling. For customer-facing applications where visual consistency matters, this default appearance often conflicts with your brand identity. watsonx Orchestrate supports full customization of the embedded chat, including colors, typography, layout, header controls, icons, and welcome messaging. You apply all customization options through documented, supported configuration properties — no internal CSS overrides or DOM manipulation needed.

​
Use cases

Brand customization is particularly relevant for:
  • Customer-facing portals such as banking, insurance, healthcare, and retail, where the chat must feel native to the site.
  • White-label products, where the application requires its own brand identity in place of vendor branding.
  • Design system compliance, where your organization enforces strict front-end standards that govern fonts, colors, and layout across all components.

​
Expected outcome

After you apply customization, the embedded chat widget uses your site’s brand colors for the header and message bubbles, displays your custom icon, and presents starter prompts aligned with your users’ most common tasks. The visual transition between the page and the chat stays consistent, and the widget feels like a native part of the application rather than a third-party component.

​
Next steps

Follow the step-by-step tutorial to apply these customizations to your own agent:
watsonx Orchestrate continuously adds new customization options. Always refer to the UI configuration reference for the most up-to-date list of supported properties.