Feature Request: Customizable Chat Bot Avatar Icon #12350

Closed
opened 2026-02-21 19:07:02 -05:00 by yindo · 1 comment
Owner

Originally created by @kingwide on GitHub (Mar 30, 2025).

Self Checks

  • I have searched for existing issues search for existing issues, including closed ones.
  • I confirm that I am using English to submit this report (我已阅读并同意 Language Policy).
  • [FOR CHINESE USERS] 请务必使用英文提交 Issue,否则会被关闭。谢谢!:)
  • Please do not modify this template :) and fill in all the required fields.

1. Is this request related to a challenge you're experiencing? Tell me about your story.

When embedding the chat bot into web applications, we noticed the avatar is hardcoded as ("icon", "🤖") (e.g., in src/components/base/chat/index.vue). While the default icon works, there's no documentation or configuration option to customize this avatar for branded integrations.

Proposed Solution
We kindly suggest one of the following improvements:

Add UI configuration for avatar upload/replacement in the bot settings, OR

Allow dynamic icon configuration via parameters/props when embedding the chat widget, OR

Document the workflow for developers to override the default icon (e.g., via CSS customization, theme files, or environment variables).

Use Case
Custom avatars are critical for maintaining brand consistency when deploying white-label chatbots. This would greatly improve implementation flexibility.

2. Additional context or comments

Thank you for considering this enhancement! We're happy to help test or provide more details if needed.

3. Can you help us with this feature?

  • I am interested in contributing to this feature.
Originally created by @kingwide on GitHub (Mar 30, 2025). ### Self Checks - [x] I have searched for existing issues [search for existing issues](https://github.com/langgenius/dify/issues), including closed ones. - [x] I confirm that I am using English to submit this report (我已阅读并同意 [Language Policy](https://github.com/langgenius/dify/issues/1542)). - [x] [FOR CHINESE USERS] 请务必使用英文提交 Issue,否则会被关闭。谢谢!:) - [x] Please do not modify this template :) and fill in all the required fields. ### 1. Is this request related to a challenge you're experiencing? Tell me about your story. When embedding the chat bot into web applications, we noticed the avatar is hardcoded as ("icon", "🤖") (e.g., in src/components/base/chat/index.vue). While the default icon works, there's no documentation or configuration option to customize this avatar for branded integrations. Proposed Solution We kindly suggest one of the following improvements: Add UI configuration for avatar upload/replacement in the bot settings, OR Allow dynamic icon configuration via parameters/props when embedding the chat widget, OR Document the workflow for developers to override the default icon (e.g., via CSS customization, theme files, or environment variables). Use Case Custom avatars are critical for maintaining brand consistency when deploying white-label chatbots. This would greatly improve implementation flexibility. ### 2. Additional context or comments Thank you for considering this enhancement! We're happy to help test or provide more details if needed. ### 3. Can you help us with this feature? - [ ] I am interested in contributing to this feature.
yindo added the 💪 enhancement label 2026-02-21 19:07:02 -05:00
yindo closed this issue 2026-02-21 19:07:02 -05:00
Author
Owner

@crazywoola commented on GitHub (Mar 30, 2025):

When embedding the chat bot into web applications, we noticed the avatar is hardcoded as ("icon", "🤖") (e.g., in src/components/base/chat/index.vue). While the default icon works, there's no documentation or configuration option to customize this avatar for branded integrations.

We use React. :)

Image

@crazywoola commented on GitHub (Mar 30, 2025): > When embedding the chat bot into web applications, we noticed the avatar is hardcoded as ("icon", "🤖") (e.g., in src/components/base/chat/index.vue). While the default icon works, there's no documentation or configuration option to customize this avatar for branded integrations. We use React. :) ![Image](https://github.com/user-attachments/assets/ef0820a6-107a-463c-a63d-d26c0f7a08f9)
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: langgenius/dify#12350