Widget Settings
Setup > Widget Settings controls how HeiChat looks on the storefront and which support or marketing entry points customers can use.
1. Appearance
Use Appearance to control the visual behavior of the chat launcher and widget.
Main settings to review:
- Desktop and mobile position
- Widget size
- Margins and z-index
- Mobile display mode
- Chat bubble style and animation
- Lazy load delay
- Brand logo, avatars, greetings, callout, and theme color
- Optional homepage inside the widget
- RTL support
- Conversation header style
Recommended setup flow:
- Pick desktop and mobile positions that do not clash with sticky UI elements.
- Set widget size and spacing.
- Decide whether mobile should use full-screen or drawer mode.
- Upload your logo and avatars.
- Write a greeting and callout that match your brand tone.
- Turn on the widget homepage only if you want customers to browse shortcuts before chatting.
2. Feature Widgets
Feature Widgets expand HeiChat beyond the main chat bubble.
Sales widgets
Common sales-focused widgets include:
- Restock Notification
- Exit Intent Popup
- Spin to Win
- Video Popup Widget
- Sales Activity Popup
These are useful when you want to:
- Capture leads on out-of-stock products
- Recover abandoning visitors
- Add urgency and social proof
Support widgets
Common support-focused widgets include:
- Product Search Widget
- Order Search Widget
- Help Desk Widget
- Feedback Widget
- Inline Chat Button
- Drawer Cart Widget
These are useful when you want to:
- Reduce repetitive support questions
- Give customers self-service order tracking
- Let customers submit structured feedback with screenshots
- Place chat directly on product pages
Step-by-step suggestions
If you are rolling this out gradually:
- Start with Product Search or Order Search if self-service is important.
- Add Feedback Widget if your support team benefits from screenshots.
- Add Restock Notification or Exit Intent only after the base experience is already stable.
3. Quick Buttons
Quick Buttons create one-click shortcuts inside the widget.
Most common buttons:
- Best Seller
- Need Help
- Talk to Human
- Q&A quick buttons
Use them to shorten the path to common intents.
Recommended order:
- Add
Need Helpif manual escalation is part of your support flow. - Add
Talk to Humanif live handoff is available on your plan. - Add
Best Sellerif chat is also used for product discovery. - Add Q&A buttons for the most repetitive questions.
4. Quick Help Guides
Quick Help Guides are clickable document links shown on the widget homepage or in chat.
For each document, prepare:
- A title
- A short summary
- A cover image URL
- A destination page URL
Important:
- These are navigation links only.
- They do not automatically become AI knowledge.
- If the same content should influence AI answers, also add it to the Knowledge Base.
5. Social Media
The Social Media area lets you add icons for channels such as Instagram, Facebook, TikTok, Messenger, Telegram, and others.
For each entry:
- Choose the platform.
- Enter the required link or ID.
- Decide whether to display it on the storefront.
If your launcher feels crowded, go back to Appearance and adjust launcher position or size.
Recommended implementation order
- Finish Appearance first.
- Add the fewest Feature Widgets that solve real problems.
- Add Quick Buttons for top customer intents.
- Add Quick Help Guides if you already have strong support content.
- Add Social Media only when those channels are actively managed.

